Playground Environment

This guide covers environment variables and configuration for the Bklit playground.

Environment Variables

VITE_BKLIT_PROJECT_ID

VITE_BKLIT_API_KEY

VITE_NGROK_URL

API host override for remote testing
Leave blank to use localhost:3000
Set when using tunnels or custom hosts
Examples:
- ngrok: https://abc123.ngrok.io
- cloudflared: https://abc123.trycloudflare.com
- production: Leave blank

Create .env in apps/playground/:

# Required
VITE_BKLIT_PROJECT_ID="your-project-id"
VITE_BKLIT_API_KEY="bk_live_your-token-here"

# Optional
# VITE_NGROK_URL="http://localhost:3000"

The playground uses these defaults:

Modify apps/playground/src/main.tsx to change SDK configuration.

VITE_BKLIT_PROJECT_ID="dev-project-id"
VITE_BKLIT_API_KEY="dev-token"
VITE_NGROK_URL="http://localhost:3000"

VITE_BKLIT_PROJECT_ID="prod-project-id"
VITE_BKLIT_API_KEY="prod-token"
# Leave VITE_NGROK_URL blank for production API

1. Install and start:

# Terminal 1: Dashboard
pnpm -F @bklit/dashboard dev

# Terminal 2: ngrok
ngrok http 3000

2. Copy HTTPS URL: https://abc123.ngrok.io

3. Update playground .env:

VITE_NGROK_URL="https://abc123.ngrok.io"

4. Restart playground to use new URL

# Start tunnel
cloudflared tunnel --url http://localhost:3000

Set in .env:

VITE_NGROK_URL="https://abc123.trycloudflare.com"

For production API testing, leave VITE_NGROK_URL blank:

# .env - production testing
VITE_BKLIT_PROJECT_ID="prod-project-id"
VITE_BKLIT_API_KEY="prod-token"
# VITE_NGROK_URL - leave blank or remove