코코넛 오픈소스
소프트웨어 프로젝트English

코코넛에 첫 기여를 시작해 보세요.

관심 있는 저장소를 고르고 로컬에서 실행해 보세요. 작더라도 목적이 분명한 개선이라면 좋은 첫 기여가 됩니다.

저장소 선택하기 진행 중인 이슈 보기 Discord에서 질문하기
  1. 01선택
  2. 02실행
  3. 03개선
  4. 04제안
01

어떤 저장소부터 살펴볼까요?

관심 분야와 경험에 맞는 저장소를 골라 보세요. 프로젝트의 배경과 전체 구조는 소개 페이지에서 확인할 수 있습니다.

FLUTTER / 온라인

coconut_wallet

Flutter 지갑 기능, 네트워크 연동, 하드웨어 월렛, 다국어 지원

FLUTTER / 오프라인

coconut_vault

에어갭 서명, 오프라인 키 관리, 기기 보안, 거래 검증

02

로컬에서 직접 실행해 보세요.

먼저 Git과 GitHub 계정을 준비하고, 각 저장소의 README에서 필요한 개발 도구를 확인하세요. 코코넛 월렛을 실행하려면 Go, Rust, protoc, 네이티브 브리지와 개발용 환경 파일도 설정해야 합니다.

coconut_lib

필요한 경우 Mock을 생성한 뒤 단위 테스트를 실행하세요.

API 문서 
git clone https://github.com/noncelab/coconut_lib.git
cd coconut_lib
dart pub get
dart test -t unit

coconut_wallet

개발할 때는 Regtest를 사용합니다. 앱을 실행하기 전에 네이티브 브리지와 환경 파일을 설정하세요.

iOS Regtest 앱 Android Regtest 앱 
git clone https://github.com/noncelab/coconut_wallet.git
cd coconut_wallet
flutter pub get
make ready
flutter run --flavor regtest

coconut_vault

Regtest Flavor로 실행하세요. 개발 환경에서도 코코넛 볼트의 네트워크 연결 차단 기능이 작동합니다.

iOS Regtest 앱 Android Regtest 앱 
git clone https://github.com/noncelab/coconut_vault.git
cd coconut_vault
flutter pub get
dart run build_runner clean && dart run build_runner build --delete-conflicting-outputs && dart run slang
flutter run --flavor regtest

coconut_design_system

패키지 사용법과 기여 절차는 README에서 확인할 수 있습니다. 검증 명령을 실행하기 전에 최신 안내를 살펴보세요.

git clone https://github.com/noncelab/coconut_design_system.git
cd coconut_design_system
flutter pub get

위 명령은 2026년 8월 12일 공개 저장소를 기준으로 확인했습니다. 이후 내용이 바뀌었을 수 있으니 최신 README를 함께 확인해 주세요.

03

작은 작업부터 시작해도 좋습니다.

처음부터 큰 기능을 맡을 필요는 없습니다. 변경 이유가 분명하고 결과를 확인하기 쉬운 작업이 첫 기여에 잘 맞습니다.

  • 버그 재현 방법 정리하기
  • 테스트 추가하거나 보강하기
  • 설정 문서 다듬기
  • 번역 개선하기
  • 접근성 살펴보기
  • 범위가 명확한 이슈 해결하기
코코넛의 모든 이슈 보기
04

이슈 확인부터 PR 제출까지

  1. 01

    확인

    작업을 시작하기 전에 같은 내용의 이슈나 PR이 있는지 찾아봅니다.

  2. 02

    논의

    이슈에 작업 의사를 남겨 주세요. 큰 기능이나 구조 변경은 코드를 작성하기 전에 먼저 방향을 맞춥니다.

  3. 03

    브랜치

    저장소를 Fork한 뒤, 한 가지 변경만 담을 브랜치를 만듭니다.

  4. 04

    구현

    코드를 수정하고 변경 내용을 확인할 수 있는 테스트나 검증 방법을 마련합니다.

  5. 05

    검증

    저장소에 안내된 검사를 실행한 뒤, 의도하지 않은 변경이 섞이지 않았는지 살펴봅니다.

  6. 06

    제안

    변경 이유와 범위, 확인 방법을 적어 PR을 엽니다.

05

PR을 열기 전에 확인해 주세요.

  • 무엇을 왜 바꿨는지 한 문장으로 설명할 수 있습니다
  • 관련 검사와 테스트를 모두 통과했습니다
  • 작업과 관계없는 파일은 포함하지 않았습니다
  • 변경 내용을 확인하는 방법을 PR에 적었습니다
  • 보안과 호환성에 미칠 영향을 확인했습니다
  • 관련 이슈가 있다면 PR에 연결했습니다

보안 취약점은 공개하지 말고 알려 주세요.

개인 키, 서명, 거래 검증, 사용자 자금에 영향을 줄 수 있는 문제라면 공개 이슈를 만들지 마세요. 먼저 유지보수 담당자에게 비공개로 알려 주세요.

hello@noncelab.com으로 제보하기

막히는 부분이 있나요?

재현할 수 있는 버그나 구체적인 개선 제안은 GitHub Issues에 남겨 주세요. 어떤 저장소를 골라야 할지 모르거나 개발 환경 설정이 어렵다면 Discord에서 편하게 질문해 주세요.

Discord에서 질문하기 GitHub 열기