快速入門

這份指南提供簡化的指示，透過範例網店和後端的範例 Sandbox，協助經驗豐富的 Node.js 開發人員立即開始使用 PWA Kit。

  • Node.js 18+ 和 npm 9+。
  • Apple Silicon 使用者：如果您尚未安裝 Rosetta，請執行 softwareupdate --install-rosetta。

如需詳細的設定指示，請參閱設定您的本機環境。

若要使用 Retail React App 範本來建立專案，並將專案連結至示範 Sandbox，請開啟終端機並執行以下命令：

在 npx 命令中，您可以將 @latest 替換為特定版本的 Retail React App，例如 @v3.0.0 或 @v2.7.3。若您未指定版本，可能會因快取到舊版本而造成意外的結果。

專案產生器指令碼將會在名為「pwa-kit-starter-project」的目錄中建立一個資料夾。請在文字編輯器中開啟這個資料夾，開始探索！

若要啟動您的本機網頁伺服器，請執行以下命令：

當開發伺服器開始運作後，您可以開啟瀏覽器並預覽您的網店：

重新整理後，對專案檔案所做的變更將在您的瀏覽器上顯示。

若要繼續開始使用 PWA Kit，請根據您的專案狀態選擇以下任一指南：

指南專案狀態
建立 On-Demand Sandbox未建立進行開發和測試的 B2C Commerce 執行個體。
設定 API 存取至少建立了一個 B2C Commerce 執行個體。
設定您的本機環境至少建立了一個 B2C Commerce 執行個體且設定了 API 存取。
推送和部署套件本機環境設定完成。