• Svelte 66.1%
  • CSS 12%
  • TypeScript 7.9%
  • Shell 7.8%
  • HTML 4.2%
  • Other 2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-15 18:22:32 -05:00
.claude Add CLAUDE.local.md for pnpm site configuration and create settings.local.json for Bash permissions 2025-08-07 04:54:59 -04:00
docs pack 2025-06-21 06:08:02 -04:00
public Add CLAUDE.local.md for pnpm site configuration and create settings.local.json for Bash permissions 2025-08-07 04:54:59 -04:00
scripts pack 2025-06-21 06:08:09 -04:00
src fix(viewer): align Markdown and Mermaid types with dependencies 2026-11-16 00:13:00 +01:00
.dockerignore pack 2025-06-21 06:08:02 -04:00
.gitignore q 2025-06-22 04:58:26 -04:00
.npmrc pack 2025-06-21 06:08:02 -04:00
ARCHITECTURE.md pack 2025-06-21 06:08:02 -04:00
CLAUDE.local.md Add CLAUDE.local.md for pnpm site configuration and create settings.local.json for Bash permissions 2025-08-07 04:54:59 -04:00
CLAUDE.md pack 2025-06-21 06:08:02 -04:00
Context.md pack 2025-06-21 06:08:02 -04:00
docker-compose.yml pack 2025-06-21 06:08:02 -04:00
Dockerfile pack 2025-06-21 06:08:02 -04:00
index.html Add CLAUDE.local.md for pnpm site configuration and create settings.local.json for Bash permissions 2025-08-07 04:54:59 -04:00
nixpacks.toml Remove npm warnings related to production configuration from nixpacks.toml and clean up the build phase comments. 2025-06-21 15:44:47 -04:00
package.json Bump vite from 6.3.5 to 6.4.5 2026-11-15 23:19:55 +00:00
pnpm-lock.yaml Bump vite from 6.3.5 to 6.4.5 2026-11-15 23:19:55 +00:00
pnpm-workspace.yaml pack 2025-06-21 06:08:09 -04:00
README.md first commit 2025-06-19 07:05:33 -04:00
svelte.config.js pack 2025-06-21 06:08:02 -04:00
tsconfig.json pack 2025-06-21 06:08:02 -04:00
tsconfig.node.json pack 2025-06-21 06:08:02 -04:00
vite.config.js Fix static assets by reverting to public directory and moving assets 2025-06-21 16:06:34 -04:00

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):

  1. 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
    
  2. Install Dependencies: Let pnpm do its magic!

    ./scripts/manage.sh install
    # or directly: pnpm install
    
  3. Start the Dev Server: Fire up the flux capacitors!

    ./scripts/manage.sh dev
    # or directly: pnpm run dev
    
  4. Open Your Browser: Navigate to http://localhost:3000 and 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! 🚢