Home

R2-Manager-Worker Documentation

Welcome to the comprehensive documentation for R2-Manager-Worker, a modern web application for managing Cloudflare R2 buckets with enterprise-grade authentication.

📖 Documentation Pages

Getting Started

• Installation & Setup - Complete guide to deploying your own instance
• Quick Start Guide - Get up and running in minutes
• Configuration Reference - Environment variables, secrets, Wrangler configuration, and hiding buckets

Core Features

• Bucket Management - Create, rename, delete R2 buckets, and bulk delete multiple buckets ✨ NEW (v1.3.0)
• Cross-Bucket Search - Search for files across all buckets with advanced filtering ✨ NEW (v1.3.0)
• Folder Management - Create, rename, copy, move, and delete folders
• File Operations - Upload, download, move, copy, and delete files
• Signed URLs & Sharing - Generate secure shareable links
• Advanced Filtering - Filter by extension, size, and date with presets

User Interface

• Light/Dark Mode - Auto-detects system preference with manual toggle (System → Light → Dark)

Development

• Development Guide - Local development setup and workflow
• API Reference - Complete API endpoint documentation
• Architecture Overview - Technical stack and file organization

Security & Authentication

• Authentication & Security - Cloudflare Access Zero Trust implementation
• JWT Validation - How JWT authentication works

Support

• Troubleshooting - Common issues and solutions
• FAQ - Frequently asked questions
• Roadmap - Planned features and enhancements

🎯 Why R2-Manager-Worker?

Cloudflare's dashboard lacks full-featured R2 file management capabilities. This tool provides:

• Complete Control - Self-hosted alternative with advanced file and folder operations
• Cross-Bucket Search - Find files across all buckets with advanced filtering (v1.3.0)
• Bulk Operations - Delete multiple buckets at once with progress tracking (v1.3.0)
• Advanced Filtering - Filter by extension, size, and date with quick presets and custom ranges
• Folder Management - Hierarchical navigation with breadcrumbs
• Enterprise SSO - GitHub authentication via Cloudflare Access Zero Trust
• Edge Performance - Deployed on Cloudflare's global network
• Modern Interface - Beautiful, responsive UI built with React 19
• Theme Support - Light/Dark mode with automatic system preference detection

⚡ Quick Links

• 🎯 Live Demo - Try R2 Bucket Manager in action
• 📰 v1.3.0 Release Article - Cross-bucket search, bulk deletion, and major improvements
• GitHub Repository
• Docker Hub
• Report an Issue
• Request a Feature
• Cloudflare Workers Documentation
• Cloudflare R2 Documentation

🚀 Tech Stack

Component	Technology	Version
Frontend	React	19.2.0
Build Tool	Vite	7.1.12
Language	TypeScript	5.9.3
Backend	Cloudflare Workers	Runtime API
Storage	Cloudflare R2	S3-compatible
Auth	Cloudflare Access	Zero Trust

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤️ for the Cloudflare community