Finder-Style Interface
r2Vault’s browser is designed to feel like a natural extension of macOS Finder, with familiar navigation patterns and visual design.Path Bar Navigation
Breadcrumb-style path bar shows your current location in the bucket hierarchy
View Modes
Switch between Icons and List views to match your workflow
Multi-Select
Select multiple files and folders for batch operations
Quick Actions
Context menus and keyboard shortcuts for fast file management
View Modes
Switch between two view modes to match your workflow:Icons View
Grid layout with large file thumbnails, perfect for visual browsing of images and media files.BrowserView.swift:154-192
The icons view uses a lazy grid with adaptive columns that automatically adjust based on window size.
List View
Compact list layout with sortable columns (Name, Kind, Size, Date Modified), ideal for browsing large folders.BrowserView.swift:196-218
Breadcrumb Navigation
The path bar at the top of the browser shows your current location and allows instant navigation to any parent folder.BrowserView.swift:82-112
Search and Filtering
The search bar in the toolbar provides real-time filtering of files and folders by name.BrowserView.swift:40
AppViewModel.swift:100-131
Quick Look Integration
Double-click any file to instantly preview it using macOS Quick Look. No download required - files stream directly from R2 via presigned URLs.QuickLookCoordinator.swift:27-45
Quick Look supports images, PDFs, videos, audio, documents, and most common file formats - all streaming directly from R2 without downloading to disk.
Drag and Drop Upload
Drag files or folders from Finder directly into the browser window to upload them to the current folder.BrowserView.swift:27-32
AppViewModel.swift:359-420
When you drag a folder, r2Vault preserves the complete folder structure in R2, including all subfolders and their contents.
Keyboard Shortcuts
File Operations
File Operations
⌘N- New folder⌘O- Upload filesDelete- Delete selected items⌘R- Refresh current folder
Selection
Selection
⌘A- Select all⌘D- Deselect all- Click - Single selection
⌘Click- Add to selection
Context Menus
Right-click any file or folder to access quick actions:BrowserView.swift:353-381
Toolbar
The browser toolbar provides quick access to common actions:1
Back/Forward Buttons
Navigate through your browsing history
2
View Mode Toggle
Switch between Icons and List view
3
Upload Menu
Upload files, upload folder, or create new folder
4
Refresh Button
Reload the current folder contents
5
Sort Menu
Sort by Name, Size, Date, or Kind
6
Selection Menu
Select all, deselect, or delete selected items
Status Bar
The status bar at the bottom shows the current selection state:BrowserView.swift:322-349
The status bar only appears when there are items in the current folder or when items are selected.
Related Features
Upload System
Learn about concurrent uploads and progress tracking
Menu Bar Widget
Quick uploads from anywhere on your Mac