Folderverse 3D
Test where spatial depth helps explain a file hierarchy and where ordinary search, focus, and keyboard controls remain better.

Context
When a tree becomes a landscape
Traditional sidebars remain efficient for most file work. Folderverse asks a narrower question: can spatial grouping make a deep or unfamiliar hierarchy easier to inspect without taking away search, focus, preview, and keyboard tools?
Decisions
Depth must explain a relationship
The experiment maps hierarchy into spatial depth and uses clustering, level-of-detail, and progressive disclosure to control visual load. Conventional controls remain first-class because a free camera is not an efficient answer to every navigation task.
System
A visual engine with ordinary escape hatches
React Three Fiber renders the scene while application state coordinates selection and settings. Local folder ingestion, ignore rules, previews, search, focus, and keyboard workflows surround the spatial model with precise tools.
Evidence
Public experiment evidence
The public repository contains the implementation and the screenshot used here. Performance, browser compatibility, and unfinished adapters remain explicit limitations rather than portfolio marketing claims.

Result
Outcomes
- The public source contains a spatial file graph, local folder ingestion, previews, search, focus, and settings workflows.
- The project documents browser constraints and planned repository integration.
- The experiment provides a concrete surface for testing when 2.5D hierarchy is informative rather than decorative.
Boundaries
Known limitations
- The portfolio review has not independently benchmarked large-directory performance.
- Browser support and local-file permissions constrain the available workflows.
- The project remains an experiment and is not described as enterprise-ready.
Provenance
Evidence ledger
Public source
The repository contains the spatial scene, layout, adapters, previews, and tests.
Review sourceRepository visual
The case-study image comes from the public project asset set.
Review sourceStack
Technologies
- Next.js
- TypeScript
- Three.js
- React Three Fiber
- Zustand
- Playwright