Vibekits — 다국어 랜덤 도구·캐주얼 웹게임

프로젝트 구성

vibekits는 랜덤 결정 도구와 캐주얼 웹게임을 하나의 다국어 웹 서비스로 묶는 프로젝트입니다. README 기준 MVP에는 한국어·영어 라우트, roulette 도구, Flappy Bird 게임, Supabase Auth hook, 랭킹·광고·공유 placeholder가 포함됩니다.

기술 구조

• React 19, TypeScript, Vite, TailwindCSS, React Router 기반 웹 앱
• react-i18next 기반 다국어 라우팅과 리소스 구성
• Supabase-ready auth, ranking, share, ads 관련 컴포넌트와 테스트
• Canvas 게임과 3D/physics 의존성까지 확장 가능한 게임 구조

화면과 게임 로직의 역할

저장소 규칙은 React UI와 순수 게임 엔진 로직을 분리합니다. UI는 라우팅, 광고, 랭킹, 공유, 로그인 상태와 lifecycle을 담당하고 게임 엔진은 loop, input, collision, scoring, rendering, resource cleanup, local high score를 담당합니다.

검증 기준

• 저장소에는 app routes, lazy loading, ads, analytics, i18n, ranking, Supabase config, game pages, pure game engine 관련 테스트가 확인됩니다.
• 게임 로직 파일은 React를 import하지 않는 구조가 유지되어야 합니다.
• 브라우저에 노출되는 VITE_* 변수에는 Supabase service-role secret을 넣지 않는 것이 안전 기준입니다.

원본 자료

실서비스: vibekits.org — 운영 중인 서비스에서 직접 확인할 수 있습니다.