在本機執行
啟動開發伺服器，確認專案、環境檔案和本機資料庫都已準備好。
進入專案根目錄，可以看到目前 Saavo 預設範本的主要結構。以下只省略了 node_modules、建置產物和本機執行快取：
剛開始開發時，先記住幾個位置：config/ 儲存產品和功能設定，src/pages/ 與 src/api/ 分別放置頁面和 API，src/core/ 放置業務邏輯，content/ 和 locales/ 管理內容與國際化。.env 只用於本機環境，Cloudflare 繫結和 Worker 設定則位於 wrangler.jsonc。
啟動本機開發伺服器：
cd my-project
npm run dev啟動前會先產生文件搜尋索引，接著由 Vite 和 Cloudflare 外掛啟動本機 Workers 執行環境。終端機會顯示實際網址，通常是：
http://127.0.0.1:5173如果連接埠已被占用，Vite 會改用其他連接埠。瀏覽器網址和本機 VITE_SITE_URL 都以終端機輸出為準，不要認定只能使用 5173。
先做一次基本檢查
開啟終端機提供的網址，依序確認：
- 首頁能正常顯示。
/docs可以開啟。- 可以進入登入和註冊頁面。
- 重新整理頁面後，沒有出現缺少資料表或繫結的錯誤。
建立專案時已初始化本機資料庫，不需要另外開啟終端機執行 wrangler d1 execute。若想再次檢查環境，可以執行：
npm run doctor
doctor 可能提示 Resend、Stripe 或 OAuth 尚未設定。只要輸出中沒有 ERROR，這些暫時未使用的服務就不影響繼續開發。
分開管理本機與正式環境
本機開發只讀取 .env。預設情況下：
SAAS_SECRET已由saavo:init產生。- Turnstile 使用 Cloudflare 測試金鑰。
- Resend、Stripe、GitHub 和 Google 等驗證資訊可以留白。
- D1、KV、R2、Queue 和 Durable Objects 由本機 Workers 執行環境模擬。
修改 .env 後，需要重新啟動 npm run dev。不要預先將正式環境的金鑰放入 .env，首次部署時會將它們寫入 .env.production。
初始化未完成時怎麼辦
如果終端機提示缺少 .env、SAAS_SECRET、資料表或產生的型別，請先停止開發伺服器，再執行：
npm run saavo:init
npm run dev日常新增資料庫遷移時，使用 npm run db:migrate:local。只有確認本機資料可以全部刪除時，才使用 npm run db:reset:local，它不是一般的修復指令。
部署前先決定要完成哪些設定
如果只是驗證部署流程，可以先保留大部分範本內容。Turnstile 可暫用 Cloudflare 官方測試金鑰，郵件則依目前選用的服務準備必要金鑰，以及自己的寄件者地址和客服信箱。Stripe、GitHub 登入和 Google 登入尚未準備好時，可以繼續略過。
正式開放使用者使用前，還應依實作章節，修改品牌、產品、價格、管理員電子郵件地址和法律頁面。快速開始只確保專案能執行與部署，不代表範本的預設內容可以直接作為你的產品發布。
下一頁：首次部署。