FileVerse is an experimental 3D desktop file browser that represents filesystem hierarchy as spatial depth. It combines familiar folder navigation with a scene where files and folders appear as navigable cards.
These screenshots show the current native Tauri app. The browser preview uses sample data; the desktop app browses local directories.
Current milestone: Stage 2 file manager basics — in progress. MVP-0 spatial browsing and the prepared macOS folder fixtures have been checked in the native app, including horizontal and diagonal trackpad input (user-confirmed). Current-folder filename search and sorting are implemented and native-checked. Windows and Linux validation is intentionally deferred to the platform-completion milestone.
| Area | Status |
|---|---|
| Tauri + React/TypeScript + Three.js app shell | Implemented |
| Rust-backed local directory access and common sidebar locations | Implemented; startup, sidebar navigation, picker selection/cancel, and folder navigation reported working |
| Spatial cards, folder navigation, Back, and breadcrumbs | Implemented; manually verified |
| Zoom, centered orbit, and depth controls | Implemented; vertical scroll was checked in the native app moving through loaded layers, while horizontal scroll and drag orbit around the loaded stack center |
| macOS empty, special-name, large-folder, permission, symlink, and mouse-drag checks | Verified in the Tauri desktop app; 9 Rust filesystem tests pass |
| Selected-root boundary; horizontal/diagonal gesture checks | Verified; horizontal/diagonal gestures were user-confirmed in the MVP-0 smoke checklist |
| Current-folder filename search | Implemented and native-checked for shortcut focus, matching results, and no-match state |
| Current-folder sorting | Implemented and native-checked for name, modified time, and size ordering |
| Bounded plain-text preview | README.md preview verified in the native app; 64 KiB truncation and rejection checks remain |
| Windows and Linux support validation | Deferred to the platform-completion milestone |
The roadmap is the source of truth for milestone progress and next steps. Keep it current as work is verified so a new contributor can see what is complete and where to continue.
- Double-click a folder card to enter it; use Back or breadcrumbs to return.
- Pinch to zoom from 72% to 160%.
- Horizontal two-finger scrolling rotates the loaded stack around its center; vertical scrolling moves through its depth layers. Drag with the primary mouse button to control yaw and pitch. Yaw can complete full revolutions; pitch is bounded so the view does not flip.
- Use the on-screen depth controls to move through the already-loaded scene rows; Reset restores the default view.
MVP-0 is focused on proving spatial browsing. Stage 2 adds filename search and sorting for the currently open folder, plus a bounded preview for selected plain-text files. File operations, cloud storage, filesystem watchers, recursive indexing, and other production file-manager features remain deferred.
Requires Node.js 20.19+ or 22.12+.
npm install
npm run devThe browser preview uses fixture data and does not access the host filesystem.
Requires Node.js, the stable Rust toolchain, and the platform prerequisites for Tauri 2.
npm install
npm run tauri dev