# Requirements Archive: v1.1 Fixes & Polish

**Archived:** 2026-03-15
**Status:** SHIPPED

For current requirements, see `.planning/REQUIREMENTS.md`.

---

# 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.

## v1.1 Requirements

Requirements for v1.1 Fixes & Polish. Each maps to roadmap phases.

### Database

- [x] **DB-01**: Threads table exists in database (schema push creates all missing tables)

### Images

- [x] **IMG-01**: User can see uploaded images displayed on item detail views
- [x] **IMG-02**: User can see item images on gear collection cards
- [x] **IMG-03**: User sees image preview area at top of item form with placeholder icon when no image is set
- [x] **IMG-04**: User can upload an image by clicking the placeholder area

### Planning

- [x] **PLAN-01**: User can create a new planning thread without errors
- [x] **PLAN-02**: User sees a polished empty state when no threads exist (clear CTA to create first thread)

### Categories

- [x] **CAT-01**: User can select a Lucide icon when creating/editing a category (icon picker)
- [x] **CAT-02**: Category icons display as Lucide icons throughout the app (cards, headers, lists)
- [x] **CAT-03**: Existing emoji categories are migrated to equivalent Lucide icons

## Future Requirements

Deferred from v1.0 Active list. Not in current roadmap.

### Search & Filtering

- **SRCH-01**: User can search items by name and filter by category

### 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-03**: User can rank/prioritize candidates within threads
- **THRD-04**: User can preview how a candidate affects setup weight/cost

### Data Management

- **DATA-01**: User can select weight units (g, oz, lb, kg)
- **DATA-02**: User can import/export gear collections via CSV

### Visualization

- **VIZ-01**: User can see weight distribution chart by category

### Setup Enhancements

- **SETUP-01**: User can classify items as base weight, worn, or consumable per setup

## Out of Scope

| Feature | Reason |
|---------|--------|
| PostgreSQL migration | SQLite sufficient for single-user app |
| Authentication / multi-user | Single user, no login needed |
| Custom comparison parameters | Complexity trap, weight/price covers 80% |
| Mobile native app | Web-first, responsive design sufficient |
| Social/sharing features | Different product |
| Price tracking / deal alerts | Requires scraping, fragile |

## Traceability

Which phases cover which requirements. Updated during roadmap creation.

| Requirement | Phase | Status |
|-------------|-------|--------|
| DB-01 | Phase 4 | Complete |
| IMG-01 | Phase 5 | Complete |
| IMG-02 | Phase 5 | Complete |
| IMG-03 | Phase 5 | Complete |
| IMG-04 | Phase 5 | Complete |
| PLAN-01 | Phase 4 | Complete |
| PLAN-02 | Phase 4 | Complete |
| CAT-01 | Phase 6 | Complete |
| CAT-02 | Phase 6 | Complete |
| CAT-03 | Phase 6 | Complete |

**Coverage:**
- v1.1 requirements: 10 total
- Mapped to phases: 10
- Unmapped: 0

---
*Requirements defined: 2026-03-15*
*Last updated: 2026-03-15 after roadmap creation*
