Local development dashboard for Cloudflare Workers
npm install localflareLocal development dashboard for Cloudflare Workers. Visualize and interact with your D1 databases, KV namespaces, R2 buckets, Durable Objects, and Queues during development.


- D1 Database Explorer - Browse tables, run SQL queries, edit data
- KV Browser - View, edit, and delete key-value pairs
- R2 File Manager - Upload, download, and manage objects
- Queue Inspector - Send test messages to queues
- Durable Objects - View and interact with DO instances
- Zero Config - Reads your wrangler.toml automatically
- Framework Agnostic - Works with any framework
``bash`
npm install -g localflareor
pnpm add -g localflareor
npx localflare
Navigate to your Cloudflare Worker project directory and run:
`bash`
localflare
This will:
1. Detect your wrangler.toml configurationhttp://localhost:8787
2. Start your worker at https://studio.localflare.dev
3. Open the dashboard at
`bash
localflare [configPath] [options]
Options:
-p, --port
-v, --verbose Verbose output
--no-open Don't open browser automatically
--no-tui Disable TUI, use simple console output
--dev Open local dashboard instead of studio.localflare.dev
-h, --help Display help
--version Display version
`
Use -- to pass options directly to wrangler:
`bashUse a specific environment
localflare -- --env staging
$3
`bash
Use default settings
localflareCustom port
localflare --port 9000With custom config path
localflare ./custom/wrangler.tomlVerbose output, don't open browser
localflare --verbose --no-open
`How It Works
Localflare uses a sidecar architecture - it runs an API worker alongside your worker in the same wrangler process. Both workers share the exact same binding instances.
`
Single wrangler dev Process
├── Your Worker (http://localhost:8787)
│ └── Your application code unchanged
├── Localflare API Worker
│ └── Dashboard API (/__localflare/*)
└── Shared Bindings
├── D1, KV, R2, Queues, DO
└── Same instances, same data
`This means:
- Your code stays untouched - No modifications needed
- Real bindings - Not mocks, actual working instances
- Queue messages work - Send messages your consumer receives
Supported Bindings
| Binding | Support | Dashboard Features |
|---------|---------|-------------------|
| D1 | ✅ Full | SQL editor, table browser, data CRUD |
| KV | ✅ Full | Key browser, value editor, bulk operations |
| R2 | ✅ Full | File browser, upload/download, metadata |
| Durable Objects | ✅ Full | Instance listing, state inspection |
| Queues | ✅ Full | Message viewer, send test messages |
| Service Bindings | ✅ Full | Automatic proxying |
Related Packages
localflare-api | API worker for the dashboard |
| localflare-core | Config parsing utilities |
| localflare-dashboard` | React dashboard UI |MIT