diff --git a/.planning/REQUIREMENTS.md b/.planning/REQUIREMENTS.md index 083344b..c4ffe70 100644 --- a/.planning/REQUIREMENTS.md +++ b/.planning/REQUIREMENTS.md @@ -1,7 +1,7 @@ # Requirements: GearBox **Defined:** 2026-03-15 -**Core Value:** Make it effortless to manage gear and plan new purchases — see how a potential buy affects your total setup weight and cost before committing. +**Core Value:** Make it effortless to manage gear and plan new purchases -- see how a potential buy affects your total setup weight and cost before committing. ## v1.1 Requirements @@ -40,7 +40,7 @@ Deferred from v1.0 Active list. Not in current roadmap. ### Thread Enhancements - **THRD-01**: User can compare candidates side-by-side on weight and price -- **THRD-02**: User can track candidate status (researching → ordered → arrived) +- **THRD-02**: User can track candidate status (researching -> ordered -> arrived) - **THRD-03**: User can rank/prioritize candidates within threads - **THRD-04**: User can preview how a candidate affects setup weight/cost @@ -74,22 +74,22 @@ Which phases cover which requirements. Updated during roadmap creation. | Requirement | Phase | Status | |-------------|-------|--------| -| DB-01 | — | Pending | -| IMG-01 | — | Pending | -| IMG-02 | — | Pending | -| IMG-03 | — | Pending | -| IMG-04 | — | Pending | -| PLAN-01 | — | Pending | -| PLAN-02 | — | Pending | -| CAT-01 | — | Pending | -| CAT-02 | — | Pending | -| CAT-03 | — | Pending | +| DB-01 | Phase 4 | Pending | +| IMG-01 | Phase 5 | Pending | +| IMG-02 | Phase 5 | Pending | +| IMG-03 | Phase 5 | Pending | +| IMG-04 | Phase 5 | Pending | +| PLAN-01 | Phase 4 | Pending | +| PLAN-02 | Phase 4 | Pending | +| CAT-01 | Phase 6 | Pending | +| CAT-02 | Phase 6 | Pending | +| CAT-03 | Phase 6 | Pending | **Coverage:** - v1.1 requirements: 10 total -- Mapped to phases: 0 -- Unmapped: 10 ⚠️ +- Mapped to phases: 10 +- Unmapped: 0 --- *Requirements defined: 2026-03-15* -*Last updated: 2026-03-15 after initial definition* +*Last updated: 2026-03-15 after roadmap creation* diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md index 3373bb5..510597c 100644 --- a/.planning/ROADMAP.md +++ b/.planning/ROADMAP.md @@ -2,23 +2,80 @@ ## Milestones -- ✅ **v1.0 MVP** — Phases 1-3 (shipped 2026-03-15) +- ✅ **v1.0 MVP** -- Phases 1-3 (shipped 2026-03-15) +- **v1.1 Fixes & Polish** -- Phases 4-6 (in progress) ## Phases
-✅ v1.0 MVP (Phases 1-3) — SHIPPED 2026-03-15 +v1.0 MVP (Phases 1-3) -- SHIPPED 2026-03-15 -- [x] Phase 1: Foundation and Collection (4/4 plans) — completed 2026-03-14 -- [x] Phase 2: Planning Threads (3/3 plans) — completed 2026-03-15 -- [x] Phase 3: Setups and Dashboard (3/3 plans) — completed 2026-03-15 +- [x] Phase 1: Foundation and Collection (4/4 plans) -- completed 2026-03-14 +- [x] Phase 2: Planning Threads (3/3 plans) -- completed 2026-03-15 +- [x] Phase 3: Setups and Dashboard (3/3 plans) -- completed 2026-03-15
+### v1.1 Fixes & Polish (In Progress) + +**Milestone Goal:** Fix broken functionality, improve image handling UX, and replace emoji categories with Lucide icon picker. + +- [ ] **Phase 4: Database & Planning Fixes** - Fix threads table and planning thread creation, polish empty states +- [ ] **Phase 5: Image Handling** - Fix image display and redesign upload UX with previews +- [ ] **Phase 6: Category Icons** - Replace emoji categories with Lucide icon picker + +## Phase Details + +### Phase 4: Database & Planning Fixes +**Goal**: Users can create and manage planning threads without errors +**Depends on**: Phase 3 (v1.0 complete) +**Requirements**: DB-01, PLAN-01, PLAN-02 +**Success Criteria** (what must be TRUE): + 1. Running database schema push creates the threads table (and any other missing tables) without errors + 2. User can create a new planning thread from the planning tab and it appears in the thread list + 3. User sees a clear, polished empty state with a call-to-action when no planning threads exist +**Plans**: TBD + +Plans: +- [ ] 04-01: TBD + +### Phase 5: Image Handling +**Goal**: Users can see and manage gear images throughout the app +**Depends on**: Phase 4 +**Requirements**: IMG-01, IMG-02, IMG-03, IMG-04 +**Success Criteria** (what must be TRUE): + 1. User can see previously uploaded images displayed correctly on item detail views + 2. Gear collection cards show item images (or a placeholder when no image exists) + 3. Item form displays an image preview area at the top with a placeholder icon when no image is set + 4. User can upload an image by clicking the placeholder area, and the preview updates immediately +**Plans**: TBD + +Plans: +- [ ] 05-01: TBD + +### Phase 6: Category Icons +**Goal**: Categories use clean Lucide icons instead of emoji +**Depends on**: Phase 4 +**Requirements**: CAT-01, CAT-02, CAT-03 +**Success Criteria** (what must be TRUE): + 1. User can browse and select a Lucide icon from a picker when creating or editing a category + 2. Category icons render as Lucide icons everywhere they appear (cards, headers, lists, dashboard) + 3. Existing emoji-based categories display as equivalent Lucide icons without manual user intervention +**Plans**: TBD + +Plans: +- [ ] 06-01: TBD + ## Progress +**Execution Order:** +Phases execute in numeric order: 4 -> 5 -> 6 + | Phase | Milestone | Plans Complete | Status | Completed | |-------|-----------|----------------|--------|-----------| | 1. Foundation and Collection | v1.0 | 4/4 | Complete | 2026-03-14 | | 2. Planning Threads | v1.0 | 3/3 | Complete | 2026-03-15 | | 3. Setups and Dashboard | v1.0 | 3/3 | Complete | 2026-03-15 | +| 4. Database & Planning Fixes | v1.1 | 0/? | Not started | - | +| 5. Image Handling | v1.1 | 0/? | Not started | - | +| 6. Category Icons | v1.1 | 0/? | Not started | - | diff --git a/.planning/STATE.md b/.planning/STATE.md index 77eee3f..c82381a 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -2,12 +2,12 @@ gsd_state_version: 1.0 milestone: v1.1 milestone_name: Fixes & Polish -status: defining_requirements +status: ready_to_plan stopped_at: null last_updated: "2026-03-15" -last_activity: 2026-03-15 — Milestone v1.1 started +last_activity: 2026-03-15 — v1.1 roadmap created progress: - total_phases: 0 + total_phases: 3 completed_phases: 0 total_plans: 0 completed_plans: 0 @@ -20,22 +20,24 @@ progress: See: .planning/PROJECT.md (updated 2026-03-15) -**Core value:** Make it effortless to manage gear and plan new purchases — see how a potential buy affects your total setup weight and cost before committing. -**Current focus:** Defining requirements for v1.1 +**Core value:** Make it effortless to manage gear and plan new purchases -- see how a potential buy affects your total setup weight and cost before committing. +**Current focus:** Phase 4 - Database & Planning Fixes ## Current Position -Phase: Not started (defining requirements) -Plan: — -Status: Defining requirements -Last activity: 2026-03-15 — Milestone v1.1 started +Phase: 4 of 6 (Database & Planning Fixes) +Plan: 0 of ? in current phase +Status: Ready to plan +Last activity: 2026-03-15 -- v1.1 roadmap created + +Progress: [░░░░░░░░░░] 0% (v1.1 phases) ## Accumulated Context ### Decisions -- Stay with SQLite — single-user app, Postgres adds unnecessary complexity -- Lucide Icons for category icons — best outdoor/gear coverage +- Stay with SQLite -- single-user app, Postgres adds unnecessary complexity +- Lucide Icons for category icons -- best outdoor/gear coverage ### Pending Todos @@ -43,12 +45,12 @@ None. ### Blockers/Concerns -- `threads` table missing from database (schema exists, never pushed) -- Images upload but don't display in UI -- Category emoji system being replaced with Lucide icons +- `threads` table missing from database (schema exists, never pushed) -- Phase 4 +- Images upload but don't display in UI -- Phase 5 +- Category emoji system being replaced with Lucide icons -- Phase 6 ## Session Continuity Last session: 2026-03-15 -Stopped at: Defining v1.1 requirements +Stopped at: v1.1 roadmap created, ready to plan Phase 4 Resume file: N/A