# r2Vault

## Docs

- [Architecture Overview](https://docs.r2vault.app/dev/architecture.md): Deep dive into r2Vault's MVVM architecture, concurrency model, and state management
- [Building from Source](https://docs.r2vault.app/dev/building-from-source.md): Learn how to build r2Vault from source on macOS
- [Contributing](https://docs.r2vault.app/dev/contributing.md): Guidelines for contributing to r2Vault development
- [R2Credentials](https://docs.r2vault.app/dev/models/r2-credentials.md): Storage credentials and configuration for Cloudflare R2
- [R2Object](https://docs.r2vault.app/dev/models/r2-object.md): Represents a file or folder entry in an R2 bucket
- [UploadItem](https://docs.r2vault.app/dev/models/upload-item.md): Model representing a completed upload entry in history
- [FileUploadTask](https://docs.r2vault.app/dev/models/upload-task.md): Tracks state and progress of file uploads to R2
- [Project Structure](https://docs.r2vault.app/dev/project-structure.md): Complete breakdown of r2Vault's directory structure and file organization
- [AppUpdater](https://docs.r2vault.app/dev/services/app-updater.md): DMG download and installation system for app updates
- [AWSV4Signer](https://docs.r2vault.app/dev/services/aws-v4-signer.md): AWS Signature Version 4 signer for S3-compatible APIs (Cloudflare R2)
- [KeychainService](https://docs.r2vault.app/dev/services/keychain-service.md): Credential storage service using UserDefaults
- [MenuBarManager](https://docs.r2vault.app/dev/services/menu-bar-manager.md): Menu bar status item and popover management for macOS
- [QuickLookCoordinator](https://docs.r2vault.app/dev/services/quick-look-coordinator.md): Quick Look panel integration for file previews directly from R2
- [R2BrowseService](https://docs.r2vault.app/dev/services/r2-browse-service.md): Browse, create, and delete objects in Cloudflare R2 using S3-compatible API
- [R2UploadService](https://docs.r2vault.app/dev/services/r2-upload-service.md): File upload service for Cloudflare R2 using S3-compatible API
- [ThumbnailCache](https://docs.r2vault.app/dev/services/thumbnail-cache.md): Thread-safe thumbnail cache with memory and disk persistence
- [UpdateService](https://docs.r2vault.app/dev/services/update-service.md): GitHub releases integration for automatic app updates
- [UploadHistoryStore](https://docs.r2vault.app/dev/services/upload-history-store.md): Persistent storage for upload history using UserDefaults
- [Technology Stack](https://docs.r2vault.app/dev/tech-stack.md): Complete overview of frameworks, APIs, and dependencies used in r2Vault
- [Auto-Update System](https://docs.r2vault.app/features/auto-updates.md): Stay up to date with automatic updates from GitHub releases
- [File Browser](https://docs.r2vault.app/features/file-browser.md): Explore r2Vault's native Finder-style interface for browsing and managing your Cloudflare R2 bucket
- [Menu Bar Widget](https://docs.r2vault.app/features/menu-bar-widget.md): Quick access to R2 uploads and recent files from the macOS menu bar
- [Upload System](https://docs.r2vault.app/features/upload-system.md): Fast, reliable concurrent uploads with real-time progress tracking and automatic URL generation
- [Browsing Files](https://docs.r2vault.app/guide/browsing.md): Navigate your R2 bucket with a Finder-style interface, search, sort, and preview files
- [Configuration & Settings](https://docs.r2vault.app/guide/configuration.md): Configure your R2 credentials and manage multiple buckets in r2Vault
- [Managing Files](https://docs.r2vault.app/guide/managing-files.md): Create folders, delete files and folders, and generate presigned URLs in r2Vault
- [Menu Bar Widget](https://docs.r2vault.app/guide/menu-bar.md): Upload files instantly from the menu bar with live progress and recent uploads
- [Uploading Files](https://docs.r2vault.app/guide/uploading.md): Upload files to R2 with drag-and-drop, live progress tracking, and automatic URL copying
- [Installation](https://docs.r2vault.app/installation.md): How to install r2Vault on macOS 15.0 or later
- [Introduction](https://docs.r2vault.app/introduction.md): A native macOS client for browsing, managing, and uploading files to Cloudflare R2
- [Quick Start](https://docs.r2vault.app/quickstart.md): Get up and running with r2Vault in 5 minutes