> ## 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

# 簡介

瞭解 supastack、包含的內容，以及啟動應用的路徑。

## 從這裡開始：您收到了什麼

該套件是一個您可以自定義的啟動應用程式。 Web是瀏覽器介面加伺服器API； Mobile是手機介面；桌面是顯示 Web 應用程式的本機視窗。 API 是客戶端呼叫以登入或讀取資料的伺服器地址。共享包是這些應用程式使用的可重用部分。

從下面的 Web 本地教程開始。它準確地告訴您如何下載庫、啟動伺服器並執行一個假 AI task。然後新增已儲存帳戶的資料庫，僅選擇您的產品所需的提供商，自定義您的品牌並準備託管。您可以稍後閱讀技術說明；它們不是開啟第一個演示的先決條件。

[安裝工具並獲取程式碼](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)


## 從共享基礎構建

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


## 選擇你的起點

從五分鐘的本地安裝開始。然後跟著每篇指南底部的“繼續安裝”連結：在準備部署之前配置資料庫、身份驗證、套餐和提供商。用完整的檔案索引查詢每個功能、提供商、元件和參考。

本地黃金路徑已在專案的開發環境中通過。計時乾淨克隆安裝、真實提供商冒煙、部署和真機驗收仍是獨立的驗證步驟。

[五分鐘完成本地安裝](https://supastack.dev/zh-tw/docs/web/ship-in-5-minutes.md)

[瀏覽全部檔案](https://supastack.dev/zh-tw/docs/web/project-structure.md)

[Mobile 安裝](https://supastack.dev/zh-tw/docs/mobile/ship-in-5-minutes.md)

[Desktop 安裝](https://supastack.dev/zh-tw/docs/desktop/ship-in-5-minutes.md)

[瞭解如何使用這些檔案](https://supastack.dev/zh-tw/docs/web/using-the-docs.md)


## 歡迎使用 supastack

supastack 是面向 AI SaaS 產品的模組化工具包：Next.js Web 應用、Expo 移動應用和 Tauri 桌面外殼，共用認證、計費、AI、任務、郵件、儲存和可觀測性等 TypeScript 包。

購買後，你會收到工具包倉庫的 GitHub 邀請：Web、Mobile、Desktop 各一個；全平臺套餐提供完整 monorepo。克隆你要交付的介面並開始改造。

這些檔案按步驟引導，而不是把資料雜亂堆在一起：先在本機執行應用，再按順序設定服務商。每篇文章都會告訴你下一步讀什麼。


## 啟動本地服務

需要 Node.js 22 或更新版本。倉庫固定了包管理器版本（packageManager: pnpm@11.19.0），通過 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 分鐘啟動](https://supastack.dev/zh-tw/docs/web/ship-in-5-minutes.md)》。


## 下一篇

[5 分鐘啟動](https://supastack.dev/zh-tw/docs/web/ship-in-5-minutes.md)