Introduction

Documentation Index

Fetch the complete documentation index at: https://docs.r2vault.app/llms.txt

Use this file to discover all available pages before exploring further.

​

What is r2Vault?

r2Vault is a native macOS application that brings the power of Cloudflare R2 storage to your desktop. Built with SwiftUI and optimized for macOS 15.0+, it provides a fast, elegant, and familiar interface for managing your R2 buckets—no browser required. Think of it as Finder for Cloudflare R2: browse files, drag-and-drop uploads, Quick Look previews, and a menu bar widget that’s always one click away.

​

Key Features

​

Browse & Navigate

• Finder-style file browser with breadcrumb navigation
• Icon and List view modes for flexible file viewing
• Search, sort, and filter files by name, size, date, or kind
• Quick Look preview with spacebar—just like in Finder

​

Upload

• Drag-and-drop files and folders directly from Finder
• Concurrent uploads with real-time progress tracking
• Cancel individual uploads or all at once
• Automatic public URL copy to clipboard on upload completion
• Upload history with copy, download, and delete actions

​

Menu Bar Widget

• Lives in the macOS menu bar—always one click away
• Drop files directly onto the popover to upload instantly
• Live per-file upload progress with cancel buttons
• Recent uploads list with copy link, download, and delete
• Stays open while you work—won’t dismiss on focus loss

​

Manage

• Create folders and delete files/folders with confirmation dialogs
• Recursive folder deletion—removes all contents in one action
• Batch delete multiple items with a single confirmation
• Multiple R2 bucket support—switch buckets from the gear menu
• Presigned URL generation for secure sharing

​

Auto-Update

• Check for Updates via the app menu (R2 Vault → Check for Updates)
• Automatic in-app download and install of new releases

​

Technology Stack

r2Vault is built with modern macOS technologies:

​

Why r2Vault?

• Native performance: Built with Swift and SwiftUI, optimized for Apple Silicon
• Privacy-first: Your credentials are stored securely in the macOS Keychain
• No subscription: Free and open source under the MIT license
• Always accessible: Menu bar integration means your files are always one click away
• Familiar interface: If you know Finder, you know r2Vault

​

Next Steps