localflare

Localflare

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

<img width="1491" height="1000" alt="image" src="https://github.com/user-attachments/assets/913505fd-4c09-4c9e-9a41-44cfc89571af" /

Features

• D1 Database Studio - Full-featured SQL editor, data browser with inline editing, filtering, sorting, bulk operations, and dummy data generation
• 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 (Next.js, Nuxt, Remix, Hono, etc.)

Quick Start

# Navigate to your Cloudflare Worker project
cd your-worker-project

# Run Localflare
npx localflare

That's it! Localflare will:

• Detect your wrangler.toml configuration
• Start your worker at http://localhost:8787
• Open the dashboard at https://studio.localflare.dev

Installation

npm install -g localflare
# or
pnpm add -g localflare
# or use directly with npx
npx localflare

Usage

Basic Usage

# Run in your Worker project directory
localflare

# Custom port
localflare --port 9000

# Custom persistence directory
localflare --persist-to ./my-data

# Don't open browser automatically
localflare --no-open

Pass Wrangler Options

Use -- to pass options directly to wrangler:

# Use a specific environment
localflare -- --env staging

# Set environment variables
localflare -- --var API_KEY:secret

# Combine options
localflare --port 9000 -- --env production --remote