Josh-Gi3r/blueballs

네오뱅크를 구축하기 위한 오픈소스 참조 플랫폼

완성 앱맘대로 써도 됨 · MIT커머스·결제JavaScript난이도

32+-1이번 주0 찜

7포크0이슈

중간맛 분석

Node.js 24.x + pnpm으로 구동하는 TypeScript 풀스택 모노레포입니다. 웹사이트·뱅킹 (181개 작업 문서화)·더블엔트리 원장·샌드박스 빌더·FX 런타임이 함께 구성되어 있으며, SQLite 또는 Cloudflare Workers로 배포할 수 있습니다. 토큰 담보·스마트컨트랙트(Solidity)·다중테넌트 격리·소수점 정확성 회계를 지원하고, 데모는 https://blueballs.tech의 제품·카드·FX· 페이지에서 바로 확인 가능합니다.

이런 레포예요

이럴 때 쓰면 좋아요

자신의 시장에 맞춘 맞춤형 디지털 은행을 구축하려는 스타트업과 금융기관
국가·지역별 규제에 맞게 카드·환전·송금 기능을 통합한 임베디드 파이낸스 플랫폼 개발
스테이블코인 기반 결제 시스템이나 토큰화된 금융 상품 프로토타입 검증

핵심 기능

181개 작업이 문서화된 테넌트 격리 뱅킹 API와 더블엔트리 원장정책·유동성·예약을 분리한 프로바이더 중립 외환 런타임Node.js/SQLite 또는 Cloudflare Workers/Durable Objects 멀티런타임 지원

대안 대비 차별점

대부분의 뱅킹 플랫폼과 달리 특정 제공자나 결제망에 종속되지 않으며, 배포자가 소유한 어댑터를 통해 은행·카드사·유동성 제공자를 플러그인 방식으로 연결할 수 있고, 토큰 담보와 원자적 정산이 선택적으로 가능합니다.

먹어본 사람들

실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.

시식평 · 먹어본 사람 한마디

아직 시식평이 없어요. 먹어보셨다면 첫 한마디를 남겨주세요.

다른 레포 시식평 구경하기 →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

이 레포, 해먹는 법

처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.

준비물

Node.js 24.15 이상 (24.x 릴리스)
pnpm 11.21 이상

바로 차려먹기Node.js (pnpm)

깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.

git clone --depth 1 https://github.com/Josh-Gi3r/blueballs.git &&
cd blueballs &&
pnpm install &&
pnpm run dev

코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.

README가 안내하는 자세한 단계 보기

저장소 클론

git clone https://github.com/Josh-Gi3r/blueballs.git
cd blueballs

패키지 매니저로 의존성 설치

pnpm install

개발 서버 시작 (웹사이트 http://localhost:5280, API http://localhost:5290/v2, FX http://localhost:8788)

pnpm dev

샌드박스 환경 생성 (http://localhost:5280/sandbox) 또는 은행 예제 실행

node examples/banking-quickstart.mjs http://localhost:5290

개별 서비스만 실행 필요 시

pnpm dev:site   # 웹사이트
pnpm dev:api    # 뱅킹 API
pnpm dev:fx     # FX 노드

깃밥트라이로 맛보기

받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.

터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.

npx gitbap-try Josh-Gi3r/blueballs

Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →

별 추이 · 7일

32+-1 / 7일

활용성 · 따라 만들기 좋은가

베스트 샘플샘플 점수 62/100

관대한 라이선스
테스트 있음
예제 디렉토리
최근 활동
AGENTS.md
llms.txt
템플릿

🟢 최근 활동 있음 · 2026년 생성

「커머스·결제」 이런 레포, 매주 받아보실래요?

매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.

내 레포인가요? README에 깃밥 배지 달기

[![깃밥](https://www.gitbap.com/badge/Josh-Gi3r/blueballs.svg)](https://www.gitbap.com/r/Josh-Gi3r/blueballs)

🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp

방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork

/plugin install gitbap-cowork@gitbap

연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기