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 /zh/docs/web.md (or send Accept: text/markdown).

简介

了解 supastack、包含的内容，以及启动应用的路径。

询问本指南

从这里开始：您收到了什么

该套件是一个您可以自定义的启动应用程序。 Web是浏览器界面加服务器API； Mobile是手机界面；桌面是显示 Web 应用程序的本机窗口。 API 是客户端调用以登录或读取数据的服务器地址。共享包是这些应用程序使用的可重用部分。

从下面的 Web 本地教程开始。它准确地告诉您如何下载库、启动服务器并运行一个假 AI task。然后添加已保存帐户的数据库，仅选择您的产品所需的提供商，自定义您的品牌并准备托管。您可以稍后阅读技术说明；它们不是打开第一个演示的先决条件。

从共享基础构建

supastack 是 Web、移动和桌面上 AI SaaS 的模块化基础。 Next.js 承载 Web UI，API、Expo 提供本机参考流程，Tauri 桌面 shell 加载相同的 Web 应用程序。共享包处理身份、工作空间、计费、人工智能、工作、电子邮件、存储和可观察性。

从本地参考流程开始，了解模块如何组合在一起。仅当该流程在您的环境中运行后才配置生产提供程序。

找到你的出路

应用程序组成共享包。产品特定的功能属于消费产品代码库，而不是可重用的核心。

apps/
  web/       Next.js interface and API routes
  mobile/    Expo application
packages/
  auth/      Identity and sessions
  db/        Schema and workspace persistence
  billing/   Billing and entitlements
  ai/        Providers, routing, and usage
  jobs/      Background job contract
  email/     Transactional delivery

选择你的起点

从五分钟的本地安装开始。然后跟着每篇指南底部的“继续安装”链接：在准备部署之前配置数据库、身份验证、套餐和提供商。用完整的文档索引查找每个功能、提供商、组件和参考。

本地黄金路径已在项目的开发环境中通过。计时干净克隆安装、真实提供商冒烟、部署和真机验收仍是独立的验证步骤。

欢迎使用 supastack

supastack 是面向 AI SaaS 产品的模块化工具包：Next.js Web 应用、Expo 移动应用和 Tauri 桌面外壳，共用认证、计费、AI、任务、邮件、存储和可观测性等 TypeScript 包。

购买后，你会收到工具包仓库的 GitHub 邀请：Web、Mobile、Desktop 各一个；全平台套餐提供完整 monorepo。克隆你要交付的界面并开始改造。

这些文档按步骤引导，而不是把资料杂乱堆在一起：先在本机运行应用，再按顺序设置服务商。每篇文章都会告诉你下一步读什么。

启动本地服务

需要 Node.js 22 或更新版本。仓库固定了包管理器版本（packageManager: [email protected]），通过 Corepack 运行 pnpm 即可，无需全局安装。

1. 复制环境变量文件，创建本地配置。

2. 安装工作区依赖。

3. 可选：启动本地 Postgres 容器以获得真实持久化；默认流程不需要它。

4. 启动开发服务器并打开 http://localhost:3000。

cp .env.example .env
corepack pnpm install
docker compose up -d postgres   # optional local database
corepack pnpm dev

# → http://localhost:3000

.env 文件

环境设置选择套件使用的本地或托管服务。将 .env.example 复制到根 .env 以进行迁移，将 .env.example 复制到 apps/web/.env.local 以进行 Web 服务器。 Expo 使用 apps/mobile/.env.local. 仅复制 root .env 不会配置每个应用程序。

默认的假/本地提供商不需要付费 API 凭证。它们让您完成内存/仪表板演示；在 /auth 进行真正的登录仍然需要 PostgreSQL 和迁移。对于真正的提供程序，仅更改 Web 配置文件中的命名设置，保存，然后停止并重新启动服务器。切勿通过 NEXT_PUBLIC_ 或 EXPO_PUBLIC_ 值暴露秘密。

选择你的路径

第一次使用？《5 分钟启动》会用默认配置带你从克隆仓库到运行应用。

要为手机或桌面构建？Mobile 和 Desktop 栏分别介绍 Expo 与 Tauri。应用启动后，可以按顺序阅读“设置服务商”中的集成指南。

如果你想继续完成设置，可以阅读《5 分钟启动》。

简介