shoppy

Shoppy: Menyematkan aplikasi demo SDK

Shoppy adalah aplikasi demo yang menampilkan kemampuan React Embedding SDK Metabase. Ini adalah dasbor e-niaga sederhana yang memungkinkan pemilik toko melihat dan menganalisis data penjualan.

Demo tersedia di https://metabase-shoppy.vercel.app.

Cara menjalankan demo di mesin Anda

Demo ini menggunakan data dari instance Metabase Cloud yang dihosting dan menyediakan server JWT yang dihosting, oleh karena itu Anda tidak perlu menjalankan server Metabase dan server JWT secara lokal.

• Buat file lingkungan lokal.

  • cp .env.example .env

• Instal dependensi yang diperlukan.

  • yarn

• Jalankan antarmuka React.

  • yarn dev

• Kunjungi http://localhost:3004 di browser Anda.

Bagaimana cara mengembangkan SDK secara lokal?

Penting

Bagian berikut ditujukan untuk karyawan Metabase yang mengerjakan SDK penyematan. Jika Anda bukan karyawan Metabase, Anda dapat melewati bagian berikut.

• Tempatkan repositori metabase di ../metabase

• Buka terminal baru dan jalankan yarn build-release:cljs && yarn build-embedding-sdk:watch di repositori metabase. Ini mengawasi perubahan dan membangun SDK penyematan dalam mode pengembangan.

• Jalankan kembali perintah berikut setiap kali Anda membuat perubahan pada sumber SDK penyematan. Ini menghubungkan kembali SDK yang dibangun ke aplikasi demo.

  • yarn dev:link && yarn dev

Bagaimana cara menjalankan demo pada server autentikasi JWT lokal?

Jika Anda tidak dapat menggunakan server JWT yang dihosting, Anda dapat menjalankan server JWT secara lokal.

• Perbarui variabel lingkungan server API di api/.env . Jika Anda adalah karyawan Metabase, lihat item "Shoppy - File Lingkungan" di brankas 1Password.

• Jalankan server API.

  • cd api && yarn && yarn dev

• Jalankan antarmuka React.

  • yarn dev:link && yarn dev