# 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.