Piggids Architecture

Piggids는 One/VXRN 기반의 web/native route를 하나의 코드베이스에서 제공하는 앱입니다.

Routing Surface

웹의 public site, 인증 및 온보딩, 앱 내부 주요 화면, API route가 모두 app/의 file-system routing 아래에 놓입니다.

Interface Layer

UI는 Tamagui와 src/interface/* 컴포넌트를 기준으로 구성합니다. Piggids 브랜드 색상과 문구는 design-system/ 가이드를 production 코드의 Tamagui prop과 local token으로 번역합니다.

Data Layer

데이터 동기화는 Zero 1.5와 on-zero 모델을 기준으로 합니다. Drizzle schema, PostgreSQL, Better Auth, local workspace packages가 서버와 개발 도구의 현재 기준입니다.

Launch Review Surface

출시 검토에서는 /, /help, /privacy-policy, /terms-of-service와 앱 내부 /home, /savings, /missions, /quizzes route를 우선 확인합니다.

Known Release Risks

public docs의 상세 문서 수는 아직 적고, repo-wide typecheck는 기존 Tamagui/native/interface debt로 실패합니다. 출시 전에는 실제 browser smoke와 주요 앱 route의 visual QA를 별도 evidence로 남겨야 합니다.

Help

Piggids 문서는 출시 준비가 진행되면서 계속 정리됩니다.