react
Featured
react
React is a JavaScript library for building user interfaces with declarative, component-based, and cross-platform design.
AI repository intelligence
FR-AI / ANALYSISWhy it is worth attention
It transforms file navigation into a surreal 3D experience with a non-Euclidean scaling trick and a zero-dependency local server or fully client-side browser version, blending utility with art and play.
Who it is for
- Developers curious about 3D file visualization
- Creative coders and digital artists
- Tech enthusiasts who enjoy experimental interfaces
- Gamers interested in file-system-based shooters
Use cases
- Exploring a folder hierarchy in an immersive 3D environment
- Demonstrating three.js and WebAudio capabilities
- Using as a quirky desktop toy or art piece
- Learning about non-Euclidean rendering and browser file system APIs
Strengths
- Runs with zero dependencies (Python stdlib only for local mode)
- Two deployment options: local server or browser-only via File System Access API
- Creative hybrid of file browser and game (invaders mode, music reactivity)
- No data upload; privacy is maintained in client-side mode
Considerations
- Full mode is localhost-only (no network access)
- Browser-only mode lacks OS integration (open-in-app, reveal-in-Finder)
- Requires Chrome or Edge for File System Access API; not universal
README quick start
◆ GEODE
Your filesystem, spatialized. Pilot a little glowing dart through space where every folder is a hollow geodesic sphere with a glowing aperture. Fly through the opening and the geode balloons around you: bigger on the inside, containing its own suns, orbiting sub-geodes, and rings of file cards.
Run
Two ways to fly:
Full mode (local server):
python3 server.py # opens http://127.0.0.1:4747 in your browser
Whole disk, open-in-app, reveal-in-Finder, ?start=/deep/links. Python 3
stdlib only; three.js is vendored in web/vendor. Localhost only.
Browser-only mode (GitHub Pages): open the hosted page in Chrome or Edge and click GRANT A FOLDER — the File System Access API lets you explore any folders you grant, fully client-side. Nothing is uploaded; there is no backend. Previews and music reactivity all work; open-in-app / reveal don't (no OS on the other side of a web page).
Fly
| input | action |
|---|---|
| MOUSE | steer |
| W / S | thrust forward / back |
| A / D | strafe |
| SPACE / C | lift / sink |
| Q / E | roll |
| SHIFT | booster (heat-limited) |
| CLICK / F | autopilot to target · open file |
| R | reveal target in Finder |
| BACKSPACE | eject up one level |
| H | toggle hidden files |
| M | mute |
| L | invaders mode — the files fight back |
Fly into a geode's glowing ring to enter it. Fly out the exit aperture (the pulsing ring, marked EXIT on your HUD) to go back up. Files open in their default app when you board them. Sealed red geodes are permission-denied.
When the files fight back
Press L inside any folder. The lights go neon, a four-note bass line starts marching, and every file in the room becomes a Space Invaders phalanx — a sphere of enemies that side-steps around you in chunky synchronized beats and contracts inward, faster as their numbers thin. Hold click for twin hitscan lasers; files die in one hit and explode in their filetype's color, folders take three and crack open. Divers telegraph with a siren before they charge. Grazing a bolt pays points, chained kills climb a pentatonic ladder, O cycles CHILL / NORMAL / NIGHTMARE.
No files are harmed — it's a costume over the live scene. Press L again and everything glides back to exactly where it was.
How it works
server.py— zero-dependency Python stdlib server: static files +/api/list,/api/roots, `
Related repositories
Similar projects matched by category, topics, and programming language.
tandpfun
Featured
wardrobe
A GPT‑image powered app that extracts individual garment cutouts from photos, organizes them into a digital wardrobe, and generates modeled outfit previews.
mshumer
Featured
Claude-of-Duty
A browser-based first-person shooter built entirely with procedural generation and orchestrated AI agents, featuring 55k lines of Three.js/WebGL2 code and no art assets.