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

產品檔案

套件隨附的專用檔案應用。

詢問本指南

開始之前

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

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

corepack pnpm --filter @supastack/web dev

安裝與配置

apps/docs 是面向購買者的檔案端面,服務於你構建的產品 —— 與這套套件檔案分開。它以導航、頁內錨點和搜尋渲染你產品自己的指南,並在開發中作為獨立的 workspace 應用執行在 3001 埠。

讓其內容與其描述的功能一起,在倉庫中保持型別化和版本化;與程式碼脫節的檔案比缺失的頁面更糟。

apps/docs/        Product documentation app
  content/        Guide sources and nav order
  app/            Routes, layout, search

實現流程

以套件結構為模板來組織你的產品檔案:一條起步路徑、每個功能區域一頁,以及配置和 API 的參考頁。複用套件的指南格式,使工具(搜尋索引、複製為 Markdown)繼續可用。

將任務與頁面關聯:釋出功能時,在同一變更中更新對應指南。

驗證與排障

構建 docs 工作區,點遍每個導航項,對引入的每個新術語執行一次搜尋,並在重新命名後檢查錨點連結。將損壞的檔案連結視為損壞的路由。