docs: ship v2.1, add v2.2 and v2.3 milestones to roadmap

This commit is contained in:
2026-04-12 17:33:14 +02:00
parent b71900efbd
commit a3ccffd5f4
2 changed files with 106 additions and 23 deletions

View File

@@ -62,15 +62,17 @@ Help people make better gear decisions — discover what others use, compare rea
### Active
## Current Milestone: v2.1 Public Discovery
## Current Milestone: v2.2 User Experience Polish
**Goal:** Transform GearBox from a login-first tool into a public-first discovery platform with always-on catalog search and a browsable feed of community content.
**Goal:** Fix broken user-facing features and polish the experience for real users — working profiles, better image handling, refreshed onboarding, and mobile refinements.
**Target features:**
- Public access auth model — browse everything without login, auth only gates collection management
- Discovery landing page replacing dashboard — catalog search bar at top, feed of popular setups/items/categories below
- Catalog enrichment infrastructure — attribution fields, source tracking, agent-friendly import tools
- Initial catalog seeding — populate key categories via MCP agent swarm
- Profile page with Logto integration for account management, branded login screens, email verification
- Image fit-within framing (letterbox/pillarbox) instead of hard crops
- Catalog-driven onboarding flow with visual refresh
- Mobile UX improvements (icon actions, touch refinements)
**Next milestone:** v2.3 Global & Social Ready — setup sharing system, multi-currency, i18n
### Future

View File

@@ -7,7 +7,9 @@
-**v1.2 Collection Power-Ups** — Phases 7-9 (shipped 2026-03-16)
-**v1.3 Research & Decision Tools** — Phases 10-13 (shipped 2026-04-08)
-**v2.0 Platform Foundation** — Phases 14-23 (shipped 2026-04-08)
- 🚧 **v2.1 Public Discovery** — Phases 24-26 (in progress)
- **v2.1 Public Discovery** — Phases 24-27 (shipped 2026-04-12)
- 🚧 **v2.2 User Experience Polish** — Phases 28-31 (in progress)
- 📋 **v2.3 Global & Social Ready** — Phases 32-34 (planned)
## Phases
@@ -64,13 +66,32 @@
</details>
### v2.1 Public Discovery (In Progress)
<details>
<summary>✅ v2.1 Public Discovery (Phases 24-27) — SHIPPED 2026-04-12</summary>
**Milestone Goal:** Transform GearBox from a login-first tool into a public-first discovery platform with always-on catalog search and a browsable feed of community content.
- [x] Phase 24: Public Access & Infrastructure (2/2 plans) — completed 2026-04-10
- [x] Phase 25: Catalog Enrichment & Agent Tools (2/2 plans) — completed 2026-04-10
- [x] Phase 26: Discovery Landing Page (3/3 plans) — completed 2026-04-10
- [x] Phase 27: Top Nav Restructure & Search Bar Rethink (4/4 plans) — completed 2026-04-12
- [x] **Phase 24: Public Access & Infrastructure** - Remove the login wall from read-only routes and add rate limiting to public endpoints (completed 2026-04-10)
- [x] **Phase 25: Catalog Enrichment & Agent Tools** - Add attribution fields to global items, bulk import API, and MCP tools for agent-powered seeding (completed 2026-04-10)
- [x] **Phase 26: Discovery Landing Page** - Replace the dashboard with a public-first landing page featuring catalog search and community feed (completed 2026-04-10)
</details>
### v2.2 User Experience Polish (In Progress)
**Milestone Goal:** Fix broken user-facing features and polish the experience for real users — working profiles, better image handling, refreshed onboarding, and mobile refinements.
- [ ] **Phase 28: Profile & Logto Integration** — Fix profile page, integrate Logto for profile management, customize login branding, configure email verification
- [ ] **Phase 29: Image Presentation** — Fit-within framing with letterbox/pillarbox instead of hard crops, optional crop positioning
- [ ] **Phase 30: Onboarding Redesign** — Catalog-driven onboarding replacing manual entry, visual refresh to match current UI (promotes 999.2)
- [ ] **Phase 31: Mobile Polish** — Icon-based action buttons on item views, small UX improvements
### v2.3 Global & Social Ready (Planned)
**Milestone Goal:** Make GearBox work for a global audience with setup sharing, multi-currency support, and localization infrastructure.
- [ ] **Phase 32: Setup Sharing System** — Visibility toggle (private/link/public), link sharing, schema future-proofed for likes, friends, and collaborative editing
- [ ] **Phase 33: Currency System** — Multi-currency support (USD/EUR/GBP), price display per user preference
- [ ] **Phase 34: i18n Foundation** — Translation framework, string extraction, locale-aware formatting
## Phase Details
@@ -145,6 +166,65 @@ Plans:
- [x] 27-03-PLAN.md — Root layout wiring, hero removal, and visual verification
**UI hint**: yes
### Phase 28: Profile & Logto Integration
**Goal**: Users have a working profile page with account management powered by Logto, branded login screens, and email verification
**Depends on**: Phase 27 (v2.1 complete)
**Requirements**: TBD (discuss phase)
**Success Criteria** (what must be TRUE):
TBD (discuss phase)
**Plans**: TBD
### Phase 29: Image Presentation
**Goal**: Images display within the fixed aspect ratio using fit-within framing (letterbox/pillarbox) instead of hard crops, preserving the full image
**Depends on**: Phase 28
**Requirements**: TBD (discuss phase)
**Success Criteria** (what must be TRUE):
TBD (discuss phase)
**Plans**: TBD
### Phase 30: Onboarding Redesign
**Goal**: New users experience a polished, catalog-driven onboarding flow that matches the current UI style and guides them through their first setup
**Depends on**: Phase 28
**Requirements**: TBD (discuss phase)
**Success Criteria** (what must be TRUE):
TBD (discuss phase)
**Plans**: TBD
**UI hint**: yes
### Phase 31: Mobile Polish
**Goal**: Mobile item views use icon-based action buttons instead of text labels, with small UX refinements across touch interactions
**Depends on**: None
**Requirements**: TBD (discuss phase)
**Success Criteria** (what must be TRUE):
TBD (discuss phase)
**Plans**: TBD
**UI hint**: yes
### Phase 32: Setup Sharing System
**Goal**: Setup owners can toggle visibility between private, link-shared, and public, with schema designed for future likes, friends, and collaborative editing
**Depends on**: Phase 28 (profiles working)
**Requirements**: TBD (discuss phase)
**Success Criteria** (what must be TRUE):
TBD (discuss phase)
**Plans**: TBD
**UI hint**: yes
### Phase 33: Currency System
**Goal**: Users can select their preferred currency (USD/EUR/GBP) and all prices display accordingly
**Depends on**: Phase 32
**Requirements**: TBD (discuss phase)
**Success Criteria** (what must be TRUE):
TBD (discuss phase)
**Plans**: TBD
### Phase 34: i18n Foundation
**Goal**: Translation framework in place with string extraction, locale-aware formatting, and at least English + one additional language
**Depends on**: Phase 33
**Requirements**: TBD (discuss phase)
**Success Criteria** (what must be TRUE):
TBD (discuss phase)
**Plans**: TBD
## Progress
| Phase | Milestone | Plans Complete | Status | Completed |
@@ -172,9 +252,17 @@ Plans:
| 21. Item & Catalog Detail Pages | v2.0 | 3/3 | Complete | 2026-04-06 |
| 22. Add-from-Catalog & Thread Integration | v2.0 | 2/2 | Complete | 2026-04-06 |
| 23. Manual Entry Fallback | v2.0 | 1/1 | Complete | 2026-04-06 |
| 24. Public Access & Infrastructure | v2.1 | 2/2 | Complete | 2026-04-10 |
| 25. Catalog Enrichment & Agent Tools | v2.1 | 1/2 | Complete | 2026-04-10 |
| 26. Discovery Landing Page | v2.1 | 3/3 | Complete | 2026-04-10 |
| 24. Public Access & Infrastructure | v2.1 | 2/2 | Complete | 2026-04-10 |
| 25. Catalog Enrichment & Agent Tools | v2.1 | 2/2 | Complete | 2026-04-10 |
| 26. Discovery Landing Page | v2.1 | 3/3 | Complete | 2026-04-10 |
| 27. Top Nav Restructure & Search Bar Rethink | v2.1 | 4/4 | Complete | 2026-04-12 |
| 28. Profile & Logto Integration | v2.2 | TBD | Pending | — |
| 29. Image Presentation | v2.2 | TBD | Pending | — |
| 30. Onboarding Redesign | v2.2 | TBD | Pending | — |
| 31. Mobile Polish | v2.2 | TBD | Pending | — |
| 32. Setup Sharing System | v2.3 | TBD | Pending | — |
| 33. Currency System | v2.3 | TBD | Pending | — |
| 34. i18n Foundation | v2.3 | TBD | Pending | — |
## Backlog
@@ -188,14 +276,7 @@ Plans:
### Phase 999.2: Revamp Onboarding Flow (BACKLOG)
**Goal**: Redesign the onboarding experience to match the current app style and flow. Replace the manual item edit form with the catalog search function. Visual refresh to align with the newer UI patterns.
**Requirements**: TBD
**Plans**: TBD
Plans:
- [ ] TBD (promote with /gsd:review-backlog when ready)
### Phase 999.4: Top Nav Navigation Restructure & Search Bar Rethink (BACKLOG)
**Goal**: Replace dashboard-based navigation with a persistent top nav bar (Home, Collection, future sections). Collection consolidates gear, threads, and setups under one section. Rethink the catalog search overlay appearance and interaction when entering from collection context.
**Status**: Promoted to Phase 30 (v2.2)
**Requirements**: TBD
**Plans**: TBD