GearBox/docs/BACKLOG.md

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-<name>.md.
5. Execute with superpowers:subagent-driven-development (recommended) or superpowers:executing-plans.
6. Remove the item from this doc when shipped.