Lab

The Stellar Lab is a suite of tools to help one learn about exploring the Stellar network.

The main branch is deployed to https://lab.stellar.org/. On the landing page at the bottom right, you can reference a commit hash of the web app version you're viewing.

Tech stack

• Next.js framework (React)
• TypeScript
• Stellar Design System for UI
• Sass for CSS styling
• TanStack (React) Query for API queries
• Zustand for state management
• Playwright for e2e tests
• Yarn Classic (v1)

Developing

yarn dev

Testing hardware wallets requires an HTTPS connection to enable U2F. The recommended way to do this is with ngrok. Once downloaded and authenticated, start ngrok, and tell the Lab to start with a public URL.

./ngrok http 3000
# in a separate terminal
# the subdomain will appear in ngrok's output
yarn start --public randomsubdomain.ngrok.io

Building for production

yarn build

To build and run production build locally:

yarn start

Tracking

To improve Lab, we use Amplitude and Google Analytics tracking in production.

If you are running your version of Lab (for Quickstart, for example), you can disable the Google Analytics by setting this env variable:

NEXT_PUBLIC_DISABLE_GOOGLE_ANALYTICS=true

No need to disable Amplitude as it runs only on lab.stellar.org.