> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 入門引導流程

從註冊到啟用工作區與套餐的受門禁路徑。

## 開始之前

使用“檔案”→“開啟資料夾”在 Visual Studio Code 中開啟下載的 supastack 專案，然後選擇“終端”→“新建終端”。儲存庫根目錄是包含 package.json、apps 和 packages 的資料夾。執行下面的命令並保持終端開啟。如果無法識別命令，請先完成工具安裝指南，然後再繼續。

首先閱讀平臺教程。伺服器是響應瀏覽器或電話請求的應用程式程式。 Web 讀取 apps/web/.env.local，Expo 讀取 apps/mobile/.env.local，資料庫遷移命令讀取 root .env。無資料庫/儀錶板演示與真實/身份驗證帳戶分開，需要遷移Postgres。僅電話或桌面結帳需要單獨執行的 Web 後端。

[安裝工具並獲取程式碼](https://supastack.dev/zh-tw/docs/web/before-you-start.md)

[學習命令、檔案和配置](https://supastack.dev/zh-tw/docs/web/terminal-basics.md)

[完成Web首次執行教程](https://supastack.dev/zh-tw/docs/web/ship-in-5-minutes.md)

```
corepack pnpm --filter @supastack/web dev
```


## 安裝與配置

註冊後，入門門禁會在進入產品功能前引導使用者完成工作區設定：/onboarding、/new-organization、/select-organization 與 /choose-plan。organization-onboarding 模組根據成員當前狀態決定該走哪一步。

流程可恢復 —— 每個門禁都在服務端重新推導正確的步驟，中途離開的使用者回來時會落在正確的介面。

```
/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。

新增產品門禁（必填資料欄位、條款確認）時，擴充套件入門評估邏輯，而不是在各 layout 裡散落重定向。


## 驗證與排障

用一個全新賬戶走完每一步，再測中途返回的使用者、受邀成員與多組織成員。驗證任何步驟在門禁通過之前都不會渲染應用外殼。


## 下一篇

[支付與訂閱](https://supastack.dev/zh-tw/docs/web/billing.md)