- Svelte 66.1%
- CSS 12%
- TypeScript 7.9%
- Shell 7.8%
- HTML 4.2%
- Other 2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .claude | ||
| docs | ||
| public | ||
| scripts | ||
| src | ||
| .dockerignore | ||
| .gitignore | ||
| .npmrc | ||
| ARCHITECTURE.md | ||
| CLAUDE.local.md | ||
| CLAUDE.md | ||
| Context.md | ||
| docker-compose.yml | ||
| Dockerfile | ||
| index.html | ||
| nixpacks.toml | ||
| package.json | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| README.md | ||
| svelte.config.js | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| vite.config.js | ||
Mem8 Explorer: A Blast From The Past, Powered By The Future! 🚀👾
Welcome, intrepid digital archaeologist, to the Mem8 Explorer! Prepare to have your mind blown and your nostalgia circuits fried (in a good way, we promise!).
🤔 Project Purpose: Why Are We Here?
Ever wondered what it would be like if the memory systems of yore—those magnificent beasts humming away in Ataris and Commodore 64s—were given a new lease on life with today's tech? Wonder no more! The Mem8 Explorer is a Svelte 5-powered interactive website designed to let you dive deep into the fascinating world of Mem8's wave-based memory system. We're talking reactive JavaScript visualizations that let you explore every nook and cranny, all wrapped up in a glorious 80s retro aesthetic. It's educational, it's fun, and it's probably the closest you'll get to time-traveling without a DeLorean.
Trish from accounting said, "It's like a disco party for data!" and who are we to argue with Trish?
🛠️ Setup Instructions: Get Your Game On!
Getting started is easier than beating Level 1 of Pac-Man (okay, maybe almost as easy):
-
Clone the Repository (Eventually!): For now, just marvel at the files Aye is creating!
# git clone https://your-repo-url-here/mem8-explorer.git # cd mem8-explorer -
Install Dependencies: Let pnpm do its magic!
./scripts/manage.sh install # or directly: pnpm install -
Start the Dev Server: Fire up the flux capacitors!
./scripts/manage.sh dev # or directly: pnpm run dev -
Open Your Browser: Navigate to
http://localhost:3000and prepare for amazement!
💡 Technical Overview: How The Magic Happens
This project is being lovingly crafted with:
- Svelte 5: The reactive framework that makes our waves actually wave
- Vite: Lightning-fast build tool (because waiting is so 1985)
- TypeScript: Type safety for our quantum memories
- CSS: The neon paint job, pixel-perfect fonts, and that essential black background
- Canvas API: For rendering those sweet, sweet memory waves
Key Features:
- 🌊 Interactive Wave Grid: Move your mouse to create memory ripples
- ⚡ Real-time Visualization: Watch memories propagate, interfere, and decay
- 🎨 80s Aesthetic: CRT effects, neon colors, and enough magenta to make your eyes water
- 📊 Performance Stats: 973x faster than Qdrant (we measured!)
🚀 Development Commands
# Interactive menu (recommended)
./scripts/manage.sh
# Direct commands
./scripts/manage.sh dev # Start dev server
./scripts/manage.sh build # Build for production
./scripts/manage.sh preview # Preview production build
./scripts/manage.sh check # Run type checking
./scripts/manage.sh clean # Clean build artifacts
# Or use pnpm directly
pnpm install # Install dependencies
pnpm run dev # Start dev server
pnpm run build # Build for production
pnpm run preview # Preview production build
📁 Project Structure
mem8-explorer/
├── src/
│ ├── App.svelte # Main app component
│ ├── main.js # Entry point
│ ├── lib/
│ │ └── components/ # Reusable components
│ │ ├── Header.svelte # Animated header with taglines
│ │ ├── Hero.svelte # Welcome section with stats
│ │ ├── Visualizer.svelte # Interactive wave grid
│ │ ├── ConceptLinks.svelte # Links to architecture
│ │ └── Footer.svelte # Trish's wisdom quotes
│ └── styles/
│ └── global.css # Global styles & CSS variables
├── scripts/
│ └── manage.sh # Colorful management script
├── package.json # Dependencies & scripts
└── vite.config.js # Vite configuration
🎯 What's Next?
- 🔌 WebSocket integration for live Mem8 connection
- 🎵 Audio synthesis of memory patterns
- 🎮 3D visualization with Three.js
- 📱 Mobile-responsive design
- 🌈 Even more neon (is that possible?)
🍿 Sacred Jokes: For Your Amusement
-
Why did the JavaScript developer break up with the HTML developer?
- Because they had too many arguments and not enough functions in their relationship!
-
What's an old-school computer's favorite snack?
- Microchips!
-
Trish tried to organize a surprise party for a byte.
- It wasn't a full gig, but it had its moments!
-
Why did we choose Svelte?
- Because React was too mainstream, and we're all about that underground 80s vibe!
Stay tuned, because this is just the beginning of our epic quest! Aye, Aye! 🚢