chore: complete v1.0 MVP milestone

Archive roadmap, requirements, and phase directories to milestones/.
Evolve PROJECT.md with validated requirements and key decisions.
Reorganize ROADMAP.md with milestone grouping.
Delete REQUIREMENTS.md (fresh for next milestone).

.planning/milestones/v1.0-phases/03-setups-and-dashboard/03-CONTEXT.md

@@ -0,0 +1,123 @@
+# Phase 3: Setups and Dashboard - Context
+
+**Gathered:** 2026-03-15
+**Status:** Ready for planning
+
+<domain>
+## Phase Boundary
+
+Named loadouts composed from collection items with live weight/cost totals, plus a dashboard home page with summary cards linking to collection, threads, and setups. No setup enhancements (weight classification, charts) — those are v2. No thread or collection changes beyond navigation restructure.
+
+</domain>
+
+<decisions>
+## Implementation Decisions
+
+### Setup Item Selection
+- Checklist picker in a SlideOutPanel showing all collection items
+- Items grouped by category with emoji headers (same grouping as collection view)
+- Toggle items on/off via checkboxes — "Done" button to confirm
+- Items can belong to multiple setups (shared, not exclusive)
+
+### Setup Creation
+- Inline name input + create button at top of setups list
+- Same pattern as thread creation in Phase 2 (text input + button)
+- No description field or extra metadata — just a name
+
+### Setup Display
+- Card grid layout grouped by category, reusing ItemCard component
+- Same visual pattern as collection view for consistency
+- Each item card gets a small × remove icon to remove from setup (not from collection)
+- No confirmation dialog for removal — non-destructive action
+- Per-category subtotals in CategoryHeader (weight/cost within this setup)
+
+### Setup Totals
+- Sticky bar at top of setup detail page showing setup name, item count, total weight, total cost
+- Reuses TotalsBar pattern — contextual stats for the current setup
+- Totals computed live from current item data
+
+### Dashboard Card Design
+- Three equal-width cards side by side on desktop, stacking vertically on mobile
+- Collection card: item count, total weight, total cost
+- Planning card: active thread count
+- Setups card: setup count
+- Summary stats on each card — at-a-glance overview before clicking in
+- Empty state: same cards with zeros, Collection card says "Get started"
+
+### Dashboard Page Header
+- "GearBox" title only on dashboard (stats already on cards, no redundancy)
+- No welcome message or greeting — clean and minimal
+
+### Navigation & URL Structure
+- `/` = Dashboard (three summary cards)
+- `/collection` = Gear | Planning tabs (moved from current `/`)
+- `/collection?tab=planning` = Planning tab
+- `/threads/:id` = Thread detail (unchanged)
+- `/setups` = Setups list
+- `/setups/:id` = Setup detail
+- "GearBox" title in TotalsBar is always a clickable link back to dashboard
+- No breadcrumbs or back arrows — GearBox title link is the only back navigation
+- Sub-pages show contextual stats in TotalsBar; dashboard shows title only
+
+### Claude's Discretion
+- Setup list card design (what stats/info to show per setup card beyond name and totals)
+- Exact Tailwind styling, spacing, and transitions for dashboard cards
+- Setup detail page layout specifics beyond the card grid + sticky totals
+- How the checklist picker handles a large number of items (scroll behavior)
+- Error states and loading skeletons
+
+</decisions>
+
+<specifics>
+## Specific Ideas
+
+- Dashboard should feel like a clean entry point — "GearBox" title, three cards, lots of whitespace
+- Setup detail should visually mirror the collection view (same card grid, category headers, tag chips) so it feels like a filtered subset of your gear
+- Removal × on cards should be subtle — don't clutter the visual consistency with collection
+- Thread creation pattern (inline input + button) is the reference for setup creation
+
+</specifics>
+
+<code_context>
+## Existing Code Insights
+
+### Reusable Assets
+- `SlideOutPanel.tsx`: Right-side slide panel — reuse for checklist item picker
+- `ItemCard.tsx`: Card with tag chips — reuse directly in setup detail view (add × icon variant)
+- `CategoryHeader.tsx`: Category section with emoji + subtotals — reuse in setup detail
+- `TotalsBar.tsx`: Sticky bar with stats — adapt for contextual stats per page
+- `ThreadCard.tsx`: Card with pill tags — pattern reference for setup list cards
+- `ConfirmDialog.tsx`: Confirmation modal — reuse for setup deletion
+- `ThreadTabs.tsx`: Tab component — reuse for gear/planning tabs on /collection
+
+### Established Patterns
+- Service layer with DB injection (`item.service.ts`, `thread.service.ts`)
+- Hono routes with Zod validation via `@hono/zod-validator`
+- TanStack Query hooks for data fetching
+- Zustand store for UI state (`uiStore.ts`)
+- API client utilities (`apiGet`, `apiPost`, `apiPut`, `apiDelete`)
+- Shared Zod schemas in `src/shared/schemas.ts`
+- Weight in grams, price in cents (integer math)
+- URL search params for tab state
+
+### Integration Points
+- Database: New `setups` and `setup_items` tables in `src/db/schema.ts`
+- Shared schemas: Setup Zod schemas in `src/shared/schemas.ts`
+- Server: New setup routes in `src/server/routes/`, mounted in `src/server/index.ts`
+- Client: New `/collection` and `/setups` routes, refactor current `/` to dashboard
+- TotalsBar: Needs to become route-aware (different stats per page)
+- Totals service: New setup totals endpoint or compute client-side from items
+
+</code_context>
+
+<deferred>
+## Deferred Ideas
+
+None — discussion stayed within phase scope
+
+</deferred>
+
+---
+
+*Phase: 03-setups-and-dashboard*
+*Context gathered: 2026-03-15*