wrangler-ui
v0.1.5
Published
Prisma Studio for Cloudflare Workers — run npx wrangler-ui in any Workers project
Downloads
897
Readme
wrangler-ui
Prisma Studio for Cloudflare Workers — run npx wrangler-ui in any Workers project to inspect and manage KV, D1, R2, and Worker metadata through a local web UI.
Installation
npm install -g wrangler-ui
# or run without installing
npx wrangler-uiAuthentication
wrangler-ui needs a Cloudflare API token to read and write KV, D1, R2, and Worker data. It looks for credentials in this order:
CLOUDFLARE_API_TOKENenvironment variable.api_tokenoroauth_tokenin~/.wrangler/config/default.toml(written bywrangler login).CLOUDFLARE_API_KEY+CLOUDFLARE_EMAILenvironment variables.
If wrangler login does not provide a token the SDK accepts, create an API token at https://dash.cloudflare.com/profile/api-tokens with at least Cloudflare Workers:Read and the resources you want to manage, then run:
set CLOUDFLARE_API_TOKEN=your_token_here
wrangler-uiUsage
In a project with a wrangler.toml, wrangler.json, or wrangler.jsonc:
# Start the UI on an available port
wrangler-ui
# Specify port and environment
wrangler-ui --port 3000 --env staging
# Do not open the browser automatically
wrangler-ui --no-open
# Point to a different project directory
wrangler-ui --cwd ./apps/my-workerThe tool reads your Cloudflare API token from CLOUDFLARE_API_TOKEN or from ~/.wrangler/config/default.toml.
Features
- Project overview — view worker name, account, compatibility date, main entry, routes, and vars.
- KV explorer — browse namespaces and keys, view and edit values.
- D1 explorer — run SQL queries against configured D1 databases.
- R2 buckets — list R2 buckets (object browsing requires S3-compatible credentials).
- Worker metadata — list scripts and view deployments/versions.
Development
# Install dependencies
npm install
# Run UI and CLI in watch mode concurrently
npm run dev
# Build everything
npm run build
# Type-check and lint
npm run typecheck
npm run lint
# Run tests
npm run testProject structure
src/cli— Node.js CLI entry point.src/server— Hono API server and Wrangler config parsing.src/ui— React + Vite frontend.
License
MIT
