sparkvault/README.md

SparkVault — Idea Tracker, Creative Whack Pack & Nano Banana 2.1 Mockup Studio

SparkVault is a self-hosted full-stack idea pipeline, creative catalyst deck, and visual mockup studio built with Node.js 22 (node:sqlite) and Google's Nano Banana 2.1 (gemini-nano-banana-2.1).

Core Features

• ⚡ Instant Quick Capture (Ctrl+K): Capture fleeting sparks with inline #tags, @category (@tshirt, @creative, @project, @research, @spark), and !high excitement boost.
• 📋 5-Stage Pipeline Board & Explorer Grid: Drag-and-drop ideas across Spark → Exploring → Building → Shipped → Archived with composite priority scoring (0–100), checklists, Markdown notes, and pros/cons.
• 🃏 64-Card Creative Whack Pack Studio:
  • Full 64-card Roger von Oech deck across 🧭 Explorer (1–16), 🎨 Artist (17–32), ⚖️ Judge (33–48), and ⚔️ Warrior (49–64).
  • Idea Collider: Collide a random Whack Pack card with an active spark to log breakthroughs or visualize twists.
  • 4-Role Creative Spread & searchable 64-card browser.
• 🍌 Nano Banana 2.1 Visual Mockup Studio (gemini-nano-banana-2.1):
  • Generate photorealistic T-Shirt Full-Front, T-Shirt 5-inch Left-Chest, Die-Cut Sticker, Poster, or Isolated Screenprint Graphic mockups.
  • Multi-Turn Iterative Image Editing: Select any existing mockup and pass a natural-language edit instruction to evolve the concept step-by-step.
  • Interactive HTML5 Canvas T-Shirt & Product Compositor: Instant garment color swatches, Left-Chest vs. Full-Front placement, vector emblems, custom image overlay, and screenprint typography.
• ⚔️ Resurfacing & Head-to-Head Arena: Pairwise idea comparisons and a stale-spark triage deck.