> ## 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/docs/web/before-you-start.md)

[学习命令、文件和配置](https://supastack.dev/zh/docs/web/terminal-basics.md)

[完成Web首次运行教程](https://supastack.dev/zh/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/docs/web/billing.md)