오락동 — 토스 인앱 캐주얼 게임 포털

프로젝트 소개

**오락동(FunHub)**은 토스(Toss) 인앱에 출시한 캐주얼 게임 포털입니다. 토스에서 자동 로그인된 사용자가 코인 하나로 여러 미니게임을 즐기는 구조로, 코인 경제·인앱 결제(IAP)·광고·랭킹 시스템까지 갖춘 상업 게임 플랫폼입니다.

각 미니게임은 독립적인 Canvas 게임 엔진으로 구현되며, 표준화된 GameBridge ABI를 통해 포털 호스트와 통신합니다. 하나의 코어 엔진으로 여러 게임을 빠르게 찍어내는 구조가 핵심입니다.

수록 게임 (12종+)

슈팅·액션

• 생존자: 탑다운 자동 슈팅 + 로그라이크 성장
• 스카이 에이스 / 스타 거너: 종스크롤 비행 슈팅, 보스전
• 브릭 위저드: 마법 연출을 더한 벽돌 깨기

퍼즐·아케이드

• 웜블록: 회전·오버플로우 블록 퍼즐
• 블록 팡: 8×8 블록 퍼즐
• 오브 머지: 물리 기반 구슬 머지
• 스택 타워: 타이밍 블록 쌓기
• 파이프 라인: 실시간 경로 구축 퍼즐

클래식

• 핀볼 클래식 / 핀볼 보스: 미션·보스전 핀볼

핵심 시스템

• 코인 경제: 게임 플레이·데일리 보너스로 코인 획득/소비
• 인앱 결제(IAP): 토스 결제 + 구글 플레이 빌링 연동
• 랭킹·프로필: 사용자별 최고 점수와 순위 경쟁
• 커뮤니티 게시판: 게임 공략·소통 공간
• 멀티 플랫폼 배포: 토스 인앱 + Android(Capacitor)

기술 스택

Vite + React 19 + TypeScript 5.9
Zustand + TanStack Query — 상태 관리
Tailwind CSS 4 — 포털 UI
Canvas / PixiJS — 게임 렌더링
GameBridge ABI — 게임↔호스트 표준 통신
Fastify + PostgreSQL 16 — 백엔드·경제 시스템
@apps-in-toss/web-framework — 토스 인앱 연동
Capacitor — Android 패키징

규모

• 12종+ 미니게임 (추가 개발 중)
• 코인·지갑·구독·IAP·세션·게시판 등 8개 핵심 도메인
• 토스 인앱 + Android 멀티 플랫폼 배포
• 세로/가로 모드 게임 혼합 (720×1280 / 1280×720)

아키텍처 특징

재사용 가능한 게임 코어 엔진(Bam1) 위에 각 미니게임을 독립 패키지로 얹는 모노레포 구조입니다. 새 게임을 추가할 때 포털·경제·결제 시스템을 재구현할 필요 없이 GameBridge ABI만 준수하면 되므로, 콘텐츠 확장 속도가 매우 빠릅니다.