Home

KV Manager Wiki

Welcome to the KV Manager documentation! This wiki provides comprehensive guides for installation, deployment, usage, and troubleshooting.

🎯 Quick Links

• Try the Live Demo - See KV Manager in action
• GitHub Repository
• v1.0.0 Release Article

📖 Documentation

Getting Started

• Installation - Set up KV Manager for local development
• Production Deployment - Deploy to Cloudflare Workers
• Docker Deployment - Run with Docker or Kubernetes
• Configuration - Environment variables and settings

Features & Usage

• Namespace Management - Create, delete, and manage namespaces
• Key Operations - CRUD operations for KV keys
• Metadata and Tags - Working with metadata and tags
• Search and Discovery - Finding keys across namespaces
• Bulk Operations - Batch processing for large operations
• Import and Export - Data migration and backups
• R2 Backup and Restore - Cloud backup to R2 storage
• Job History - Tracking and monitoring bulk operations
• Audit Logging - Operation history and compliance
• Webhooks - Event-driven HTTP notifications

Technical Documentation

• Architecture - System design and components
• API Reference - Complete API documentation
• Database Schema - D1 database structure
• Progress Tracking - How async operations work
• Authentication - Cloudflare Access integration

Guides & Resources

• User Guide - Step-by-step usage instructions
• Migration Guide - Upgrading from older versions
• Troubleshooting - Common issues and solutions
• Security Best Practices - Hardening your deployment
• Contributing - How to contribute to the project
• Changelog - Release notes and version history

🚀 Quick Start

Local Development

# Install dependencies
npm install

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

# Start development servers
npm run dev  # Terminal 1 (Frontend)
npx wrangler dev --config wrangler.dev.toml --local  # Terminal 2 (Worker)

Access at: http://localhost:5173

Docker Quick Start

docker pull writenotenow/kv-manager:latest

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

Access at: http://localhost:8787

💡 What is KV Manager?

KV Manager is a modern, full-featured web application for managing Cloudflare Workers KV namespaces and keys. It provides:

• Intuitive UI - Beautiful, responsive interface built with React and Tailwind CSS
• Enterprise Auth - Cloudflare Access (Zero Trust) integration
• Dual Metadata - KV Native (1024 bytes) + D1 Custom (unlimited)
• Advanced Search - Cross-namespace search with tag filtering
• Bulk Operations - Process thousands of keys efficiently
• R2 Backups - Cloud-native backup and restore
• Job History - Complete audit trail with event timelines
• Dark Mode - System-aware theme support

🛠️ Tech Stack

• Frontend: React 19.2.0 + TypeScript 5.9.3 + Vite 7.2.2 + Tailwind CSS 3.4.18
• Backend: Cloudflare Workers + KV + D1 + R2 + Durable Objects
• Auth: Cloudflare Access (Zero Trust)
• UI: shadcn/ui components

📝 Version

Current Version: v2.1.0
Last Updated: December 11, 2025

🤝 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: admin@adamic.tech

📄 License

MIT License - see LICENSE for details