For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/web/onboarding.md (or send Accept: text/markdown).
온보딩 플로우
가입부터 활성 워크스페이스와 플랜까지의 게이트 경로.
시작하기 전에
파일 → 폴더 열기를 사용하여 Visual Studio Code에서 다운로드한 supastack 프로젝트를 연 다음 터미널 → 새 터미널을 선택합니다. 저장소 루트는 package.json, 앱 및 패키지가 포함된 폴더입니다. 아래 명령을 실행하고 터미널을 열어 두십시오. 명령이 인식되지 않으면 계속하기 전에 도구 설치 가이드를 완료하세요.
먼저 플랫폼 튜토리얼을 읽어보세요. 서버는 브라우저 또는 전화 요청에 응답하는 앱 프로세스입니다. 웹은 apps/web/.env.local를 읽고, Expo는 apps/mobile/.env.local를 읽고, 데이터베이스 마이그레이션 명령은 루트 .env를 읽습니다. 데이터베이스 없는 /dashboard 데모는 Postgres를 마이그레이션해야 하는 실제 /auth 계정과 별개입니다. 전화 또는 데스크톱 전용 결제에는 별도로 실행되는 웹 백엔드가 필요합니다.
corepack pnpm --filter @supastack/web dev설치 및 설정
가입 후 온보딩 게이트는 제품 작업 전에 워크스페이스 설정을 거치게 합니다: /onboarding, /new-organization, /select-organization, /choose-plan. 조직 온보딩 모듈이 멤버의 현재 상태에서 적용할 단계를 결정합니다.
플로우는 재개 가능합니다 — 각 게이트가 서버에서 올바른 단계를 다시 도출하므로, 중간에 나간 사용자도 돌아오면 올바른 화면에 도착합니다.
/onboarding entry gate
/new-organization create a team workspace
/select-organization pick an existing one
/choose-plan plan selection before billing
/invite/[token] invited members join here구현 워크플로
각 단계를 마법사 페이지가 아닌 게이트로 취급하세요 — 서버가 상태를 평가하고 다음 필수 단계로 리다이렉트합니다. 초대된 멤버는 생성을 건너뛰고 accept-invite로 도착합니다.
제품 게이트 — 필수 프로필 필드, 약관 동의 — 를 추가할 때는 레이아웃에 리다이렉트를 흩뿌리는 대신 온보딩 평가를 확장하세요.
검증 및 문제 해결
새 계정의 모든 단계, 플로우 중간에 돌아오는 사용자, 초대된 멤버, 여러 조직의 멤버를 테스트하세요. 어떤 단계도 게이트를 통과하기 전에 앱 셸을 렌더링하지 않는지 확인하세요.