# GearBox — Backlog *Migrated from `.planning/` on 2026-04-23. Forward-looking only — see `STATE.md` for what's shipped.* Staging area for work not yet brainstormed into a superpowers plan. To start on anything here, run `superpowers:brainstorming` → `superpowers:writing-plans` → `superpowers:subagent-driven-development` (or `executing-plans`). --- ## v2.4 tail — finish line - [ ] **Verify Phase 38 Admin Tag Management** — all 2 plans marked complete in roadmap, STATE.md says 97%. Run the phase verification and close out v2.4. - [ ] **Manufacturer picker UI** — backend entity is shipped (`manufacturers` table, service, route, FK on `globalItems`, seeding), but the user-facing picker component (analogous to `CategoryPicker`) is not yet built. The manual add form still takes freeform brand text in places. See also the pending todo below. --- ## Pending todos Details preserved in `docs/backlog/todos/`. Only truly-open items listed here — the older v2.3 todos (wrong modal, missing images, slow loading, auth redirect, cursor pointer) all shipped in Phase 35. - [ ] **Make tag selector in global search searchable** (2026-04-20, ui) — the tag selector inside `CatalogSearchOverlay.tsx` should support typing-to-filter. Currently scrollable only. - [ ] **Add manufacturer picker UI** (from 2026-04-10 "add-manufacturer-entity" todo) — backend shipped; picker component + wiring into the manual add form and catalog enrichment is the remaining slice. **Dropped** (already resolved but stale in `.planning/todos/pending/`): - `add-cursor-pointer-to-all-clickable-links` → shipped in Phase 35 (FIX-05) - `fix-item-image-not-showing-on-collection-overview` → shipped in Phase 35 (FIX-02) - `fix-storage-service-tests` → resolved; `withImageUrl`/`withImageUrls` both exported and test imports match - `investigate-slow-image-loading` → shipped in Phase 35 (FIX-03, lazy loading + skeletons) - `auth-prompt-sign-in-button-should-redirect-directly-to-logto` → shipped in Phase 35 (FIX-04) - `fix-add-candidate-button-shows-wrong-modal-on-thread-page` → shipped in Phase 35 (FIX-01) --- ## Backlog phases (pre-brainstorm) These are product intents, not plans. Each needs brainstorming before becoming a superpowers plan. Sourced from `.planning/ROADMAP.md` Backlog section. *Previously-listed entries 999.2, 999.3, 999.4, 999.6 were promoted to shipped phases and are omitted here.* ### 999.1 — Rewrite E2E Tests for OIDC Auth E2E tests expect local username/password login, but auth moved to Logto. Rewrite with a mock OIDC provider or API-key bypass. Postgres seed migration already done. ### 999.5 — Legal Pages: ToS, Privacy Policy, Compliance Terms of Service, Privacy Policy, and any required compliance pages. Essential before opening to real users. ### 999.7 — User Feedback System In-app feedback collection — bug reports, feature requests, general feedback. Simple form, widget, or external integration. ### 999.8 — Analytics Integration Privacy-respecting analytics (PostHog, Umami, or similar). Usage patterns, popular categories, search behavior, feature adoption. Self-hosted preferred to align with independent ethos. ### 999.9 — Mobile App PWA first (offline, home-screen install), then evaluate native (React Native / Flutter) for richer experience — camera for weight verification, barcode scanning, etc. ### 999.10 — Monetization Strategy How GearBox sustains itself. Options: sponsored/promoted items, premium features, affiliate links. Critical tension: revenue vs. credibility — GearBox's value is *unbiased* gear data. Needs deep discussion before implementation. ### 999.11 — Marketing Website Standalone marketing site (`www.gearbox.de`) separate from the app (`app.gearbox.de`). Hero, value prop, feature highlights, how-it-works, social proof, sign-up CTA. The public-facing front door. ### 999.12 — Admin UX Polish (new, 2026-04-20) Overhaul admin panel UX: TanStack Table (sortable/groupable columns), cmdk for GitLab-style composable filter bar (field→operator→value token input), hide FAB on `/admin/*`, replace tag inline form with popup modal, show tags expanded on item rows (collapse to +N when tight), group items by brand, prominent search bar on both admin list pages. --- ## Near-future scope (v2.5 candidates) Explicitly planned for the next milestone but not yet a phase: - **Tag-based spec schemas on global items** — key/value typed specs per category, sub-tag hierarchy. Enables proper structured product data per gear class. - **Global item engagement stats** — view count, likes/saves, setup appearances. Feeds future sorting/ranking. - **ComparisonTable currency normalization** — hooks are in place; needs real multi-currency test data to prove out. --- ## Deferred requirements (tracked, not scheduled) Not in any current or v2.5 phase. Promote to a backlog phase when timing is right. ### Personalization - **PERS-01** — Logged-in feed tuned to the user's collection categories - **PERS-02** — Feed algorithm recommends by hobby interests ### Reviews & Content - **REVW-01/02/03** — Structured reviews on catalog items; surface in discovery feed; curated/linked external reviews - **REV-01/02/03** — Overall star rating, dimension ratings (durability, value), average ratings on item detail - **MOD-01/02/03** — Freeform text reviews, report inappropriate content, admin review + action *(gated on moderation infra)* ### SEO - **SEO-01** — Catalog pages crawlable by bots - **SEO-02** — Meta tags + structured data ### Catalog Seeding - **SEED-04** — Initial seeding run populates 100+ items across key categories via agent swarm *(crawl scripts exist — this would be the production run)* ### Aggregation - **AGG-01** — Crowd-verified specs on item detail (manufacturer vs community-measured weight) - **AGG-02** — "Which setups include this item" - **AGG-03** — "Commonly paired with" setup composition insights ### Social - **SOCL-01** — Fork/copy a public setup as template - **SOCL-02** — Thread candidates auto-populate from global items - **SOCL-03** — Follow other users - **SOCL-04** — Activity feed of followed users' content --- ## Workflow **To start work on something here:** 1. Pick an item above. 2. Run `superpowers:brainstorming` to turn the intent into a spec. 3. For non-trivial work, create a feature branch off `Develop` (e.g., `feature/manufacturer-picker`, `fix/tag-selector-search`). 4. Run `superpowers:writing-plans` to produce `docs/superpowers/plans/YYYY-MM-DD-.md`. 5. Execute with `superpowers:subagent-driven-development` (recommended) or `superpowers:executing-plans`. 6. Remove the item from this doc when shipped.