Saavo

建立專案

透過 Saavo 帳號授權 CLI，下載範本並自動準備本機開發環境。

先開啟 Saavo 帳號中心，在「我的產品」確認能看到 Saavo Starter 和目前可用的範本版本。這裡顯示的是帳號實際擁有的權限，授權 CLI 時也要使用同一個帳號。

Saavo 帳號中心

帳號中心提供的 ZIP，適合需要查看原始發行檔案的情況。一般建立專案時，建議使用 Saavo CLI，它會完成下載驗證、專案命名和本機初始化，比手動下載 ZIP 更方便。

執行建立指令

開始前，請確認已安裝 Node.js 和 npm，詳細步驟請參閱事前準備。

開啟終端機，進入準備存放專案的上層目錄，再執行：

npx saavo-cli@latest create my-project

第一次使用時，CLI 會開啟瀏覽器並前往 saavo.dev。請登入擁有範本使用權限的帳號，閱讀授權內容後允許存取。

Saavo 授權

完成授權後，回到終端機。CLI 會繼續檢查 Node.js、npm 和範本權限，不需要再複製權杖或下載連結。如果尚未購買 Saavo Starter 範本，授權後會顯示：

◆  Logged in as saavo (xxx@xxx.com).
│
■  SAAVO CLI FAILED
│  No templates are available for saavo (xxx@xxx.com). The account may not have template access, or no release has been published.

授權前，請先確認帳號具有取得範本的權限，否則無法建立專案。

可以將 my-project 換成自己的專案名稱。名稱請使用小寫英文字母、數字和連字號，並避免與既有專案重名。

選擇本機初始化

如果一切順利，範本下載並驗證完成後，終端機會詢問：

Prepare the project for local development?
Installs dependencies, creates .env, and initializes local databases.

是否初始化本機環境

這裡選擇 Yes。CLI 接著會：

  • 使用 npm ci 或 npm install 安裝相依套件。
  • 呼叫範本中的 npm run saavo:init。
  • 從 example.vars 建立本機 .env。
  • 產生專屬於這個專案的 SAAS_SECRET。
  • 產生 Cloudflare 型別。
  • 產生文件、部落格內容集合及其型別。
  • 初始化本機 D1 資料庫，並套用遷移。
  • 執行 doctor，檢查本機設定。

這可能需要一些時間，完成後會顯示下一步提示：

本機初始化完成

這時不需要手動複製 example.vars，也不需要逐條執行 D1 SQL。.env 已保留 Cloudflare 官方 Turnstile 測試金鑰。尚未使用的 Stripe、OAuth、通知和 R2 API 驗證資訊，可以繼續留白。

不要提交本機環境檔案

.env 已列入 Git 忽略清單，其中的 SAAS_SECRET 不能提交，也不要複製到其他專案。日後部署時，deploy:init 會將同一組應用程式金鑰寫入同樣被忽略的 .env.production。

如果建立時略過初始化

專案檔案仍會保留。進入專案目錄後執行：

npm install
npm run saavo:init

看到 Local development environment is ready 後，再繼續下一步。如果初始化中途失敗，也使用這組指令恢復，不要改回舊的手動建庫流程。

下一頁：在本機執行。