shoppy

Shoppy：嵌入 SDK 演示應用程式

Shoppy 是一個演示應用程序，展示了 Metabase 的 React Embedding SDK 的功能。這是一個簡單的電子商務儀表板，可讓店主查看和分析銷售數據。

此示範可在 https://metabase-shoppy.vercel.app 上取得。

如何在您的機器上運行演示

此示範使用託管 Metabase Cloud 執行個體中的資料並提供託管 JWT 伺服器，因此您不需要在本機上執行 Metabase 伺服器和 JWT 伺服器。

• 建立本機環境文件。

  • cp .env.example .env

• 安裝所需的依賴項。

  • yarn

• 運行 React 前端。

  • yarn dev

• 在瀏覽器中造訪http://localhost:3004 。

如何本地開發SDK？

重要的

以下部分適用於從事嵌入 SDK 工作的 Metabase 員工。如果您不是 Metabase 員工，則可以跳過以下部分。

• 將元資料庫儲存庫放置在../metabase中

• 開啟一個新終端並在元資料庫儲存庫中執行yarn build-release:cljs && yarn build-embedding-sdk:watch 。這會監視變更並在開發模式下建置嵌入 SDK。

• 每次變更嵌入 SDK 的原始程式碼時，請重新執行以下命令。這會將建置的 SDK 重新連結到演示應用程式。

  • yarn dev:link && yarn dev

如何針對本機 JWT 身份驗證伺服器運行演示？

如果您無法使用託管的 JWT 伺服器，您可以在本機上執行 JWT 伺服器。

• 更新api/.env中 API 伺服器的環境變數。如果您是 Metabase 員工，請參閱 1Password 保管庫上的「Shoppy - 環境文件」項目。

• 運行 API 伺服器。

  • cd api && yarn && yarn dev

• 運行 React 前端。

  • yarn dev:link && yarn dev