Cloudflare KV Manager

Last Updated November 27, 2025 - Production/Stable Version 1.0.0

Tech Stack

Frontend: React 19.2.0 | TypeScript 5.9.3 | shadcn/ui | Tailwind CSS | Vite | 7.2.4 Backend: Cloudflare Workers + KV + D1 + R2 + Durable Objects + Zero Trust

A full-featured management platform for Cloudflare Workers KV, designed for engineering teams and large-scale workloads. Browse namespaces, run bulk operations, search across your entire KV footprint, manage metadata and tags, automate backups to R2, and secure everything with Cloudflare Access Zero Trust.

Live Demo • Docker • Wiki • Changelog • Release Article

✨ Key Features

• 🗂️ Namespace & Key Management - Full CRUD operations with cursor-based pagination
• 📊 Dual Metadata System - KV Native (1024 bytes) + D1 Custom (unlimited) metadata
• 🏷️ Tag Organization - Unlimited tags stored in D1 for easy filtering and search
• 🔍 Advanced Search - Cross-namespace search by key name, tags, and custom metadata
• ⚡ Bulk Operations - Process thousands of keys efficiently (delete, copy, TTL, tags)
• 📥 Import/Export - JSON/NDJSON support with collision handling
• ☁️ R2 Backup & Restore - Cloud-native backup with batch operations
• 📈 Job History - Complete audit trail with event timelines and advanced filtering
• 🔐 Enterprise Auth - Cloudflare Access (Zero Trust) integration
• 🎨 Modern UI - Dark/light themes, responsive design, built with React + Tailwind CSS

🐳 Docker Quick Start

docker pull writenotenow/kv-manager:latest

docker run -d \
  -p 8787:8787 \
  -e ACCOUNT_ID=your_cloudflare_account_id \
  -e API_KEY=your_cloudflare_api_token \
  -e TEAM_DOMAIN=https://yourteam.cloudflareaccess.com \
  -e POLICY_AUD=your_cloudflare_access_aud_tag \
  --name kv-manager \
  writenotenow/kv-manager:latest

Full Docker Guide → - Docker Compose, Kubernetes, reverse proxy, security

💻 Local Development

Prerequisites: Node.js 18+, Wrangler CLI

# Install dependencies
npm install

# Initialize D1 database
npx wrangler d1 execute kv-manager-metadata-dev --local --file=worker/schema.sql

# Start dev servers (2 terminals)
npm run dev  # Terminal 1: Frontend (http://localhost:5173)
npx wrangler dev --config wrangler.dev.toml --local  # Terminal 2: Worker (http://localhost:8787)

Note: Auth bypassed for localhost. Mock data provided without credentials.

Complete Setup Guide →

🚀 Production Deployment

# Create D1 database
wrangler d1 create kv-manager-metadata

# Initialize schema (new installation)
wrangler d1 execute kv-manager-metadata --remote --file=worker/schema.sql

# Or migrate (existing installation)
wrangler d1 execute kv-manager-metadata --remote --file=worker/migrations/apply_all_migrations.sql

# Set secrets
wrangler secret put ACCOUNT_ID
wrangler secret put API_KEY
wrangler secret put TEAM_DOMAIN
wrangler secret put POLICY_AUD

# Build and deploy
npm run build
wrangler deploy

Production Deployment Guide → - Complete setup with Cloudflare Access configuration

📚 Documentation

User Guides

• User Guide - Complete usage instructions
• Namespace Management - Creating, managing, and organizing namespaces
• Key Operations - Working with keys and values
• Metadata and Tags - Using dual metadata systems
• Search and Discovery - Finding keys across namespaces
• Bulk Operations - Batch processing at scale
• Import and Export - Data migration
• R2 Backup and Restore - Cloud backups
• Job History - Monitoring operations
• Audit Logging - Compliance and tracking

Technical Documentation

• API Reference - Complete REST API documentation
• Architecture - System design and components
• Database Schema - D1 database structure
• Authentication - Cloudflare Access integration

Deployment & Operations

• Installation - Local development setup
• Production Deployment - Deploy to Cloudflare Workers
• Docker Deployment - Docker, Compose, Kubernetes
• Migration Guide - Upgrading from older versions
• Troubleshooting - Common issues and solutions
• Security Best Practices - Hardening your deployment

🗄️ Database

KV Manager uses Cloudflare D1 (SQLite) for metadata, tags, audit logs, and job tracking.

Database Schema Documentation →

🎨 User Interface

Modern, responsive design with dark/light theme support. Navigate between:

• Namespaces - Browse and manage KV namespaces
• Search - Cross-namespace key search
• Job History - View bulk operations
• Audit Log - Operation tracking

🔐 Security

• Cloudflare Access JWT validation on all production API requests
• Auth bypassed for localhost development
• Comprehensive audit logging
• Protected namespaces hidden from UI

Security Best Practices →

🆘 Troubleshooting

Common issues:

• Worker not starting - Ensure Wrangler is installed, Node 18+
• Frontend connection issues - Verify VITE_WORKER_API in .env
• D1 errors - Reinitialize with worker/schema.sql
• Search not working - Keys need D1 metadata (auto-indexed when created via UI)

Complete Troubleshooting Guide →

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Contributing Guide →

📄 License

MIT License - see LICENSE for details

💬 Support

• 🐛 Issues: GitHub Issues
• 💭 Discussions: GitHub Discussions
• 📧 Email: admin@adamic.tech

⭐ Show Your Support

If you find KV Manager useful, please consider giving it a star on GitHub!

---

Made with ❤️ for the Cloudflare community