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