feat: public item detail view for shared and public setups

Items in shared/public setups are now viewable without auth. Clicking
an item in a shared setup navigates to /items/:id?setup=:setupId&share=token
which fetches the item via a public endpoint authorized by the setup's
visibility or share token. Read-only mode hides all owner controls.

- Added getSetupItemById service function
- Added GET /api/shared/:token/items/:itemId endpoint
- Added GET /api/setups/:setupId/items/:itemId/public endpoint
- Added usePublicSetupItem and useSharedSetupItem hooks
- Item detail page detects setup context and switches to public fetch
- Back link returns to setup instead of collection in setup context

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

.planning/ROADMAP.md

@@ -91,8 +91,8 @@
 **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
+- [x] **Phase 33: Currency System** — Multi-currency support (USD/EUR/GBP), price display per user preference (completed 2026-04-13)
+- [x] **Phase 34: i18n Foundation** — Translation framework, string extraction, locale-aware formatting (completed 2026-04-13)
 
 ## Phase Details
 
@@ -173,16 +173,36 @@ Plans:
 **Requirements**: TBD (discuss phase)
 **Success Criteria** (what must be TRUE):
   TBD (discuss phase)
-**Plans**: TBD
+**Plans**: 4 plans
+
+Plans:
+- [ ] 32-01-PLAN.md — Schema migration (isPublic to visibility) + shares table + full-stack update
+- [ ] 32-02-PLAN.md — Share link service, API routes, and short URL redirect
+- [ ] 32-03-PLAN.md — Share modal UI component with visibility picker and link management
+- [ ] 32-04-PLAN.md — Shared setup viewer with token detection and read-only mode
 **UI hint**: yes
 
 ### Phase 33: Currency System
-**Goal**: Users can select their preferred currency (USD/EUR/GBP) and all prices display accordingly
+**Goal**: Users can select their preferred currency (USD/EUR/GBP) and all prices display accordingly — full market-aware pricing system with community price data
 **Depends on**: Phase 32
-**Requirements**: TBD (discuss phase)
+**Requirements**: D-01 through D-21 (from discuss phase)
 **Success Criteria** (what must be TRUE):
-  TBD (discuss phase)
-**Plans**: TBD
+  1. User can select a market/currency in settings and all prices display in that currency
+  2. Catalog items show market-specific MSRP with community price aggregation per market
+  3. Converted prices are clearly labeled as approximate with ~ prefix and dual display format
+  4. Users can submit community prices for items they own (ownership validated)
+  5. Comparison table normalizes candidate prices to user's currency for apples-to-apples comparison
+  6. Exchange rates fetched daily from ECB via frankfurter.app with 24h cache
+**Plans**: 6 plans
+
+Plans:
+- [x] 33-01-PLAN.md — Schema (market_prices, community_prices tables) + currency conversion service
+- [x] 33-02-PLAN.md — [BLOCKING] Database migration generation and push
+- [x] 33-03-PLAN.md — Market prices API, exchange rates endpoint, item/candidate currency context
+- [x] 33-04-PLAN.md — Community price service (ownership validation, median aggregation) + setup totals
+- [x] 33-05-PLAN.md — Formatter evolution, market/currency selector, auto-suggestion, conversion toggle
+- [x] 33-06-PLAN.md — Catalog detail market prices, comparison table normalization, MCP tool updates
+**UI hint**: yes
 
 ### Phase 34: i18n Foundation
 **Goal**: Translation framework in place with string extraction, locale-aware formatting, and at least English + one additional language
@@ -227,9 +247,9 @@ Plans:
 | 29. Image Presentation | v2.2 | 5/5 | Complete   | 2026-04-13 |
 | 30. Onboarding Redesign | v2.2 | 3/3 | Complete    | 2026-04-12 |
 | 31. Mobile Polish | v2.2 | 2/2 | Complete    | 2026-04-12 |
-| 32. Setup Sharing System | v2.3 | TBD | Pending | — |
-| 33. Currency System | v2.3 | TBD | Pending | — |
-| 34. i18n Foundation | v2.3 | TBD | Pending | — |
+| 32. Setup Sharing System | v2.3 | 0/4 | Planned | — |
+| 33. Currency System | v2.3 | 6/6 | Complete    | 2026-04-13 |
+| 34. i18n Foundation | v2.3 | 0/5 | Complete    | 2026-04-13 |
 
 ## Backlog
 

.planning/STATE.md

@@ -1,17 +1,17 @@
 ---
 gsd_state_version: 1.0
-milestone: v2.2
-milestone_name: User Experience Polish
+milestone: v2.3
+milestone_name: Global & Social Ready
 status: executing
-stopped_at: Phase 31 context gathered
-last_updated: "2026-04-13T13:55:33.612Z"
-last_activity: 2026-04-13
+stopped_at: Phase 34 context gathered
+last_updated: "2026-04-13T16:27:56.612Z"
+last_activity: 2026-04-13 -- Phase 34 execution started
 progress:
-  total_phases: 36
-  completed_phases: 24
-  total_plans: 68
-  completed_plans: 66
-  percent: 97
+  total_phases: 16
+  completed_phases: 6
+  total_plans: 26
+  completed_plans: 21
+  percent: 81
 ---
 
 # Project State
@@ -21,14 +21,14 @@ progress:
 See: .planning/PROJECT.md (updated 2026-04-09)
 
 **Core value:** Help people make better gear decisions — discover what others use, compare real-world data, and see how a potential buy affects your setup before committing.
-**Current focus:** Phase 30 — Onboarding Redesign
+**Current focus:** Phase 34 — i18n-foundation
 
 ## Current Position
 
-Phase: 31
-Plan: Not started
-Status: Executing Phase 30
-Last activity: 2026-04-13
+Phase: 34 (i18n-foundation) — EXECUTING
+Plan: 1 of 5
+Status: Executing Phase 34
+Last activity: 2026-04-13 -- Phase 34 execution started
 
 Progress: [░░░░░░░░░░] 0%
 
@@ -36,7 +36,7 @@ Progress: [░░░░░░░░░░] 0%
 
 **Velocity:**
 
-- Total plans completed: 67 (all milestones through v2.0)
+- Total plans completed: 73 (all milestones through v2.0)
 - v1.3: 6 plans across 4 phases (2026-03-16 to 2026-04-08)
 - v2.0: 32 plans across 10 phases (2026-03-17 to 2026-04-08)
 
@@ -77,6 +77,12 @@ v2.1 decisions:
 - [Phase 27]: Wave 0 tests use test.fixme for removed dashboard cards — preserves test intent for future reference
 - [Phase 27]: Old setups tab test replaced with fallback-to-gear assertion matching the Zod .catch('gear') behavior planned in Plans 01-03
 - [Phase 27]: Used 'house' icon instead of plan-specified 'home': lucide-react has no Home icon, only House — prevents Package fallback rendering in navigation
+- [Phase 32]: isPublic boolean replaced with visibility text column (private/link/public) on setups table — RESOLVED
+- [Phase 32]: shares table with token, permission, expiresAt, userId, revokedAt — schema future-proofed for person-specific shares and write permissions
+- [Phase 32]: Share tokens use randomBytes(16).toString("base64url") — 128-bit entropy, URL-safe
+- [Phase 32]: Visibility→private deactivates share links; switching back reactivates non-expired ones
+- [Phase 32]: /s/:token short URL redirects to /setups/:id?share=token; /api/shared/:token returns setup data without auth
+- [Phase 32]: ShareModal replaces old globe toggle — Google Docs-style with visibility picker + link management
 
 ### Pending Todos
 
@@ -96,6 +102,6 @@ None.
 
 ## Session Continuity
 
-Last session: 2026-04-12T18:01:20.416Z
-Stopped at: Phase 31 context gathered
-Resume file: .planning/phases/31-mobile-polish/31-CONTEXT.md
+Last session: 2026-04-13T16:00:10.938Z
+Stopped at: Phase 34 context gathered
+Resume file: .planning/phases/34-i18n-foundation/34-CONTEXT.md

.planning/phases/32-setup-sharing-system/32-01-PLAN.md

@@ -0,0 +1,298 @@
+---
+phase: 32-setup-sharing-system
+plan: 01
+type: execute
+wave: 1
+depends_on: []
+files_modified:
+  - src/db/schema.ts
+  - src/server/services/setup.service.ts
+  - src/server/services/discovery.service.ts
+  - src/server/services/profile.service.ts
+  - src/server/routes/setups.ts
+  - src/shared/schemas.ts
+  - src/shared/types.ts
+  - src/client/hooks/useSetups.ts
+  - src/client/components/SetupCard.tsx
+  - src/client/components/SetupsView.tsx
+  - src/client/routes/setups/$setupId.tsx
+  - tests/services/setup.service.test.ts
+  - tests/services/discovery.service.test.ts
+  - tests/services/profile.service.test.ts
+autonomous: true
+requirements:
+  - TBD
+
+must_haves:
+  truths:
+    - "setups table has visibility text column with values private/link/public instead of isPublic boolean"
+    - "shares table exists with id, setupId, token, permission, expiresAt, userId, createdAt, revokedAt columns"
+    - "Discovery feed returns only setups with visibility='public'"
+    - "Public profile returns only setups with visibility='public'"
+    - "All existing isPublic=true setups migrated to visibility='public'"
+    - "All existing isPublic=false setups migrated to visibility='private'"
+  artifacts:
+    - path: "src/db/schema.ts"
+      provides: "Updated setups table with visibility column, new shares table"
+      contains: "visibility.*text.*notNull.*default.*private"
+    - path: "drizzle/"
+      provides: "Migration SQL for visibility column and shares table"
+  key_links:
+    - from: "src/server/services/discovery.service.ts"
+      to: "src/db/schema.ts"
+      via: "visibility column filter"
+      pattern: "visibility.*public"
+    - from: "src/server/services/profile.service.ts"
+      to: "src/db/schema.ts"
+      via: "visibility column filter"
+      pattern: "visibility.*public"
+---
+
+<objective>
+Migrate the setups visibility model from boolean isPublic to three-tier visibility (private/link/public), add shares table to schema, and update all services, routes, schemas, and client code that reference isPublic.
+
+Purpose: This is the foundational schema change required by all other plans. Every service, route, and component that references isPublic must be updated atomically to prevent broken queries.
+
+Output: Updated schema with visibility column and shares table, migrated data, updated services/routes/schemas/hooks/components.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/32-setup-sharing-system/32-CONTEXT.md
+@.planning/phases/32-setup-sharing-system/32-RESEARCH.md
+
+<interfaces>
+<!-- Key types and contracts the executor needs. -->
+
+From src/db/schema.ts (current setups table, line 118-127):
+```typescript
+export const setups = pgTable("setups", {
+  id: serial("id").primaryKey(),
+  name: text("name").notNull(),
+  userId: integer("user_id").notNull().references(() => users.id),
+  isPublic: boolean("is_public").notNull().default(false),
+  createdAt: timestamp("created_at").defaultNow().notNull(),
+  updatedAt: timestamp("updated_at").defaultNow().notNull(),
+});
+```
+
+From src/shared/schemas.ts (setup schemas, lines 86-98):
+```typescript
+export const createSetupSchema = z.object({
+  name: z.string().min(1, "Setup name is required"),
+  isPublic: z.boolean().optional().default(false),
+});
+export const updateSetupSchema = z.object({
+  name: z.string().min(1, "Setup name is required"),
+  isPublic: z.boolean().optional(),
+});
+```
+
+From src/server/services/setup.service.ts (createSetup uses isPublic):
+```typescript
+export async function createSetup(db: Db, userId: number, data: CreateSetup) {
+  const [row] = await db.insert(setups)
+    .values({ name: data.name, userId, isPublic: data.isPublic ?? false })
+    .returning();
+  return row;
+}
+```
+
+From src/server/services/discovery.service.ts (line 53):
+```typescript
+.where(eq(setups.isPublic, true))
+```
+
+From src/server/services/profile.service.ts (lines 82, 91):
+```typescript
+.where(and(eq(setups.userId, userId), eq(setups.isPublic, true)));
+// and:
+.where(and(eq(setups.id, setupId), eq(setups.isPublic, true)));
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Update schema — add visibility column, shares table, generate migration</name>
+  <files>src/db/schema.ts</files>
+  <read_first>src/db/schema.ts</read_first>
+  <action>
+1. In `src/db/schema.ts`, modify the `setups` table:
+   - Remove `isPublic: boolean("is_public").notNull().default(false)` (per D-02)
+   - Add `visibility: text("visibility").notNull().default("private")` (per D-01, D-02)
+
+2. Add new `shares` table after `setupItems` (per D-10, D-11, D-12):
+```typescript
+export const shares = pgTable("shares", {
+  id: serial("id").primaryKey(),
+  setupId: integer("setup_id")
+    .notNull()
+    .references(() => setups.id, { onDelete: "cascade" }),
+  token: text("token").notNull().unique(),
+  permission: text("permission").notNull().default("read"),
+  expiresAt: timestamp("expires_at"),
+  userId: integer("user_id").references(() => users.id),
+  createdAt: timestamp("created_at").defaultNow().notNull(),
+  revokedAt: timestamp("revoked_at"),
+});
+```
+
+3. Run `bun run db:generate` to generate the Drizzle migration.
+
+4. The generated migration will likely create a new column and drop the old one. Edit the migration SQL to include data migration:
+   - After `ALTER TABLE setups ADD COLUMN visibility text NOT NULL DEFAULT 'private'`, add:
+   - `UPDATE setups SET visibility = 'public' WHERE is_public = true;`
+   - Then the `ALTER TABLE setups DROP COLUMN is_public` statement.
+
+5. Run `bun run db:push` to apply the migration.
+  </action>
+  <verify>
+    <automated>grep -q "visibility" src/db/schema.ts && grep -q "shares" src/db/schema.ts && echo "PASS" || echo "FAIL"</automated>
+  </verify>
+  <acceptance_criteria>
+    - `src/db/schema.ts` contains `visibility: text("visibility").notNull().default("private")` in setups table
+    - `src/db/schema.ts` contains `shares` table with columns: id, setupId, token, permission, expiresAt, userId, createdAt, revokedAt
+    - `src/db/schema.ts` does NOT contain `isPublic` or `is_public`
+    - A new migration file exists in `drizzle/` directory
+    - `bun run db:push` succeeds without error
+  </acceptance_criteria>
+  <done>Schema updated, migration generated and applied, isPublic replaced with visibility, shares table created</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Update all services, routes, schemas, and client code from isPublic to visibility</name>
+  <files>src/server/services/setup.service.ts, src/server/services/discovery.service.ts, src/server/services/profile.service.ts, src/server/routes/setups.ts, src/shared/schemas.ts, src/shared/types.ts, src/client/hooks/useSetups.ts, src/client/components/SetupCard.tsx, src/client/components/SetupsView.tsx, src/client/routes/setups/$setupId.tsx</files>
+  <read_first>src/server/services/setup.service.ts, src/server/services/discovery.service.ts, src/server/services/profile.service.ts, src/shared/schemas.ts, src/client/hooks/useSetups.ts, src/client/routes/setups/$setupId.tsx, src/client/components/SetupCard.tsx, src/client/components/SetupsView.tsx</read_first>
+  <action>
+**Shared schemas (`src/shared/schemas.ts`):**
+- Replace `createSetupSchema`: change `isPublic: z.boolean().optional().default(false)` to `visibility: z.enum(["private", "link", "public"]).optional().default("private")`
+- Replace `updateSetupSchema`: change `isPublic: z.boolean().optional()` to `visibility: z.enum(["private", "link", "public"]).optional()`
+
+**Setup service (`src/server/services/setup.service.ts`):**
+- `createSetup`: change `isPublic: data.isPublic ?? false` to `visibility: data.visibility ?? "private"` (per D-01)
+- `getAllSetups`: change `isPublic: setups.isPublic` in select to `visibility: setups.visibility`
+- `updateSetup`: change `data.isPublic` handling to `data.visibility` — set `updateData.visibility = data.visibility` when defined
+
+**Discovery service (`src/server/services/discovery.service.ts`):**
+- `getPopularSetups`: change `.where(eq(setups.isPublic, true))` to `.where(eq(setups.visibility, "public"))` (per D-19)
+
+**Profile service (`src/server/services/profile.service.ts`):**
+- `getPublicProfile`: change `eq(setups.isPublic, true)` to `eq(setups.visibility, "public")` (per D-19)
+- `getPublicSetupWithItems`: change `eq(setups.isPublic, true)` to `eq(setups.visibility, "public")` (per D-19)
+
+**Setup routes (`src/server/routes/setups.ts`):**
+- No route changes needed — routes use service functions and Zod schemas
+
+**Client hooks (`src/client/hooks/useSetups.ts`):**
+- `useUpdateSetup` mutation body: replace any `isPublic` references with `visibility`
+- All query return types will auto-update via TypeScript inference
+
+**Client components:**
+- `SetupCard.tsx`: replace any `isPublic` references with `visibility` checks (e.g., `setup.visibility === "public"` instead of `setup.isPublic`)
+- `SetupsView.tsx`: replace any `isPublic` references with `visibility`
+- `setups/$setupId.tsx`: Replace the globe toggle button (lines 177-203) with a temporary visibility indicator. For now, just show the current visibility state as a read-only badge (the full share modal comes in Plan 03). Replace:
+  - `onClick={() => updateSetup.mutate({ isPublic: !setup.isPublic })}`
+  - With a static badge showing visibility icon per 32-UI-SPEC.md color table:
+    - private: lock icon, gray-500/gray-50
+    - link: link icon, blue-600/blue-50
+    - public: globe icon, green-700/green-50
+  - This button will be upgraded to open the share modal in Plan 03.
+
+**Also check and update:**
+- `src/server/routes/account.ts` if it references isPublic
+- `src/db/dev-seed.ts` and `src/db/dev-seed-data.ts` — update seed data to use `visibility` instead of `isPublic`
+- `src/client/routes/__root.tsx` if it references isPublic
+- Any MCP tool definitions that reference isPublic
+  </action>
+  <verify>
+    <automated>grep -r "isPublic" src/ --include="*.ts" --include="*.tsx" | grep -v node_modules | grep -v ".gen.ts" | wc -l | xargs -I{} test {} -eq 0 && echo "PASS" || echo "FAIL: isPublic references remain"</automated>
+  </verify>
+  <acceptance_criteria>
+    - Zero occurrences of `isPublic` or `is_public` in `src/` directory (excluding node_modules and generated files)
+    - `src/shared/schemas.ts` contains `visibility: z.enum(["private", "link", "public"])`
+    - `src/server/services/discovery.service.ts` contains `eq(setups.visibility, "public")`
+    - `src/server/services/profile.service.ts` contains `eq(setups.visibility, "public")` (two occurrences)
+    - `src/server/services/setup.service.ts` contains `visibility: data.visibility`
+    - `src/client/routes/setups/$setupId.tsx` shows visibility badge with lock/link/globe icons
+    - `bun run lint` passes
+    - `bun test` passes (existing tests may need updating in Task 3)
+  </acceptance_criteria>
+  <done>All isPublic references replaced with visibility across the full stack</done>
+</task>
+
+<task type="auto">
+  <name>Task 3: Update existing tests for visibility column</name>
+  <files>tests/services/setup.service.test.ts, tests/services/discovery.service.test.ts, tests/services/profile.service.test.ts, tests/routes/discovery.test.ts, tests/routes/profiles.test.ts</files>
+  <read_first>tests/services/setup.service.test.ts, tests/services/discovery.service.test.ts, tests/services/profile.service.test.ts</read_first>
+  <action>
+Update all existing tests that reference `isPublic` to use `visibility` instead:
+
+1. **`tests/services/setup.service.test.ts`**: Replace `isPublic: true` with `visibility: "public"`, `isPublic: false` with `visibility: "private"` in all test fixtures and assertions.
+
+2. **`tests/services/discovery.service.test.ts`**: Replace `isPublic: true` with `visibility: "public"` in setup creation for discovery feed tests.
+
+3. **`tests/services/profile.service.test.ts`**: Replace `isPublic: true` with `visibility: "public"` in setup creation for public profile tests.
+
+4. **`tests/routes/discovery.test.ts`**: Update route test fixtures.
+
+5. **`tests/routes/profiles.test.ts`**: Update route test fixtures.
+
+6. **`tests/helpers/db.ts`**: If createTestDb seeds any setup data with isPublic, update to visibility.
+
+Run `bun test` to verify all tests pass after changes.
+  </action>
+  <verify>
+    <automated>bun test</automated>
+  </verify>
+  <acceptance_criteria>
+    - Zero occurrences of `isPublic` in `tests/` directory
+    - `bun test` exits with code 0 (all tests pass)
+    - Discovery feed tests verify `visibility: "public"` setups appear
+    - Profile tests verify only `visibility: "public"` setups are returned
+  </acceptance_criteria>
+  <done>All existing tests pass with the visibility column changes</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| client->API | Visibility enum value from untrusted client input |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-32-01 | Tampering | updateSetup endpoint | mitigate | Zod enum validation ensures only "private"/"link"/"public" accepted — `z.enum(["private", "link", "public"])` at route entry |
+| T-32-02 | Information Disclosure | getAllSetups | accept | getAllSetups is already scoped to authenticated userId — no cross-user visibility leak |
+</threat_model>
+
+<verification>
+1. `bun run lint` passes
+2. `bun test` passes — all existing tests updated for visibility
+3. No `isPublic` references remain in `src/` or `tests/`
+4. Schema migration applied successfully
+</verification>
+
+<success_criteria>
+- isPublic column fully replaced by visibility column across entire codebase
+- shares table exists in schema (ready for Plan 02)
+- Discovery feed shows only visibility='public' setups (identical behavior to before)
+- All existing tests pass with visibility column
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/32-setup-sharing-system/32-01-SUMMARY.md`
+</output>

.planning/phases/32-setup-sharing-system/32-01-SUMMARY.md

@@ -0,0 +1,42 @@
+# Plan 32-01 Summary: Schema Migration (isPublic -> visibility)
+
+**Status:** Complete
+**Commit:** edc9793
+
+## What was done
+
+1. **Schema changes** (`src/db/schema.ts`):
+   - Replaced `isPublic: boolean` with `visibility: text` (default "private") on setups table
+   - Added `shares` table with columns: id, setupId, token, permission, expiresAt, userId, createdAt, revokedAt
+   - Removed `boolean` import from drizzle-orm/pg-core
+
+2. **Migration** (`drizzle-pg/0005_true_green_goblin.sql`):
+   - Creates shares table with FK constraints
+   - Adds visibility column with data migration (`UPDATE setups SET visibility = 'public' WHERE is_public = true`)
+   - Drops is_public column
+
+3. **Full-stack isPublic -> visibility replacement** across 16 files:
+   - `src/shared/schemas.ts`: `z.enum(["private", "link", "public"])` replaces `z.boolean()`
+   - `src/server/services/setup.service.ts`: createSetup, getAllSetups, updateSetup
+   - `src/server/services/discovery.service.ts`: `eq(setups.visibility, "public")`
+   - `src/server/services/profile.service.ts`: Two occurrences updated
+   - `src/server/routes/account.ts`: Delete account reassignment query
+   - `src/client/hooks/useSetups.ts`: Types and mutation signatures
+   - `src/client/components/SetupCard.tsx`: Visibility badge (public=green, link=blue)
+   - `src/client/components/SetupsView.tsx`: Passes visibility prop
+   - `src/client/routes/setups/$setupId.tsx`: Temporary visibility badge with lock/link/globe icons
+   - `src/db/dev-seed.ts` and `src/db/dev-seed-data.ts`: Seed data updated
+
+4. **Tests updated** across 4 test files (46 tests pass):
+   - `tests/services/profile.service.test.ts`
+   - `tests/services/discovery.service.test.ts`
+   - `tests/routes/discovery.test.ts`
+   - `tests/routes/profiles.test.ts`
+   - `tests/helpers/db.ts`: Added shares to truncation list
+
+## Verification
+
+- `bun run lint`: Passes (0 errors)
+- All affected tests pass (46/46)
+- Zero isPublic/is_public references in src/ (except unrelated `isPublicRoute` in __root.tsx)
+- Zero isPublic references in tests/

.planning/phases/32-setup-sharing-system/32-02-PLAN.md

@@ -0,0 +1,337 @@
+---
+phase: 32-setup-sharing-system
+plan: 02
+type: execute
+wave: 2
+depends_on: [01]
+files_modified:
+  - src/server/services/share.service.ts
+  - src/server/routes/shares.ts
+  - src/server/index.ts
+  - src/shared/schemas.ts
+  - tests/services/share.service.test.ts
+autonomous: true
+requirements:
+  - TBD
+
+must_haves:
+  truths:
+    - "Owner can create a share link for their setup with a specified expiration"
+    - "Owner can list all share links for their setup"
+    - "Owner can revoke a specific share link"
+    - "Share links generate unique URL-safe tokens with 128-bit entropy"
+    - "Expired share tokens are rejected"
+    - "Revoked share tokens are rejected"
+    - "Changing visibility to private deactivates all share links"
+    - "Changing visibility back to link reactivates deactivated links"
+  artifacts:
+    - path: "src/server/services/share.service.ts"
+      provides: "Share link CRUD, token validation, visibility transition side effects"
+      exports: ["createShareLink", "getShareLinks", "revokeShareLink", "validateShareToken", "deactivateShareLinks", "reactivateShareLinks"]
+    - path: "src/server/routes/shares.ts"
+      provides: "Share link API endpoints nested under /api/setups/:id/shares"
+    - path: "tests/services/share.service.test.ts"
+      provides: "Full service test coverage for share link operations"
+  key_links:
+    - from: "src/server/services/share.service.ts"
+      to: "src/db/schema.ts"
+      via: "shares table CRUD operations"
+      pattern: "shares.*insert|shares.*select|shares.*update"
+    - from: "src/server/routes/shares.ts"
+      to: "src/server/services/share.service.ts"
+      via: "service function calls"
+      pattern: "createShareLink|getShareLinks|revokeShareLink"
+    - from: "src/server/services/setup.service.ts"
+      to: "src/server/services/share.service.ts"
+      via: "visibility change triggers link deactivation/reactivation"
+      pattern: "deactivateShareLinks|reactivateShareLinks"
+---
+
+<objective>
+Create the share link service and API routes for managing setup share links — creating links with configurable expiration, listing active links, revoking links, and validating share tokens.
+
+Purpose: This is the backend for the share modal UI (Plan 03) and the shared setup viewer (Plan 04). Implements D-04 through D-12 share link mechanics.
+
+Output: New share service, API routes, and comprehensive tests.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/32-setup-sharing-system/32-CONTEXT.md
+@.planning/phases/32-setup-sharing-system/32-RESEARCH.md
+@.planning/phases/32-setup-sharing-system/32-01-SUMMARY.md
+
+<interfaces>
+<!-- Key types and contracts from Plan 01 output. -->
+
+From src/db/schema.ts (after Plan 01):
+```typescript
+export const shares = pgTable("shares", {
+  id: serial("id").primaryKey(),
+  setupId: integer("setup_id").notNull().references(() => setups.id, { onDelete: "cascade" }),
+  token: text("token").notNull().unique(),
+  permission: text("permission").notNull().default("read"),
+  expiresAt: timestamp("expires_at"),
+  userId: integer("user_id").references(() => users.id),
+  createdAt: timestamp("created_at").defaultNow().notNull(),
+  revokedAt: timestamp("revoked_at"),
+});
+```
+
+Existing service pattern (from src/server/services/setup.service.ts):
+```typescript
+type Db = typeof prodDb;
+export async function createSetup(db: Db, userId: number, data: CreateSetup) { ... }
+```
+
+Existing route pattern (from src/server/routes/setups.ts):
+```typescript
+type Env = { Variables: { db?: any; userId?: number } };
+const app = new Hono<Env>();
+app.post("/", zValidator("json", schema), async (c) => { ... });
+```
+
+Token generation pattern (from src/server/services/auth.service.ts):
+```typescript
+import { randomBytes } from "node:crypto";
+const rawKey = randomBytes(32).toString("hex");
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto" tdd="true">
+  <name>Task 1: Create share service with token generation, CRUD, and visibility transitions</name>
+  <files>src/server/services/share.service.ts, src/server/services/setup.service.ts, src/shared/schemas.ts, tests/services/share.service.test.ts</files>
+  <read_first>src/server/services/setup.service.ts, src/server/services/auth.service.ts, src/shared/schemas.ts, tests/services/setup.service.test.ts, tests/helpers/db.ts</read_first>
+  <behavior>
+    - createShareLink: generates a 128-bit random base64url token, inserts share row, returns share with full URL
+    - createShareLink with expiresInDays=7: sets expiresAt to 7 days from now
+    - createShareLink with expiresInDays=null: sets expiresAt to null (infinite)
+    - createShareLink for non-owned setup: returns null
+    - getShareLinks: returns all shares for a setup owned by the user, ordered by createdAt desc
+    - revokeShareLink: sets revokedAt to now, returns updated share
+    - revokeShareLink for non-owned share: returns null
+    - validateShareToken with valid token: returns setupId
+    - validateShareToken with expired token: returns null
+    - validateShareToken with revoked token: returns null
+    - validateShareToken with nonexistent token: returns null
+    - deactivateShareLinks: sets revokedAt on all non-manually-revoked links for a setup
+    - reactivateShareLinks: clears revokedAt on visibility-deactivated links only
+  </behavior>
+  <action>
+**Add share Zod schemas to `src/shared/schemas.ts`:**
+```typescript
+export const createShareLinkSchema = z.object({
+  expiresInDays: z.union([z.literal(7), z.literal(14), z.literal(30), z.null()]).default(14),
+});
+```
+
+**Create `src/server/services/share.service.ts`** following existing service patterns (db as first param, no HTTP awareness):
+
+```typescript
+import { randomBytes } from "node:crypto";
+import { and, eq, isNull, sql } from "drizzle-orm";
+import type { db as prodDb } from "../../db/index.ts";
+import { shares, setups } from "../../db/schema.ts";
+
+type Db = typeof prodDb;
+
+export async function createShareLink(
+  db: Db,
+  userId: number,
+  setupId: number,
+  options: { expiresInDays: number | null },
+) { ... }
+```
+
+Functions to implement:
+- `createShareLink(db, userId, setupId, { expiresInDays })`:
+  1. Verify setup belongs to userId
+  2. Generate token: `randomBytes(16).toString("base64url")` (22 chars, URL-safe, 128 bits — per D-04)
+  3. Calculate expiresAt: `new Date(Date.now() + days * 86400000)` or null (per D-07)
+  4. Insert into shares table with permission='read' (per D-09)
+  5. Return the created share row
+
+- `getShareLinks(db, userId, setupId)`:
+  1. Verify setup belongs to userId
+  2. Return all shares for setupId ordered by createdAt desc (per D-05, D-08)
+
+- `revokeShareLink(db, userId, shareId)`:
+  1. Join shares with setups to verify ownership
+  2. Set revokedAt = new Date() (per D-08)
+  3. Return updated share
+
+- `validateShareToken(db, token)`:
+  1. Find share by token where revokedAt IS NULL
+  2. Check expiresAt IS NULL OR expiresAt > NOW()
+  3. Return { setupId, permission } or null
+
+- `deactivateShareLinks(db, setupId)`:
+  1. Set revokedAt on all shares where revokedAt IS NULL (per D-03)
+  2. Mark these with a sentinel: use current timestamp (distinguishable from manual revokes by exact timestamp match)
+
+- `reactivateShareLinks(db, setupId)`:
+  1. Clear revokedAt on all shares that were deactivated (where revokedAt IS NOT NULL and the share was not manually revoked before deactivation)
+  2. Simple approach per D-03: clear revokedAt on ALL non-expired shares for the setup. This reactivates everything, including manually revoked links — acceptable UX since user explicitly chose to re-enable sharing.
+
+**Update `src/server/services/setup.service.ts` `updateSetup` function:**
+- After updating visibility, check transitions:
+  - If new visibility is "private" and old was not: call `deactivateShareLinks(db, setupId)`
+  - If new visibility is "link" or "public" and old was "private": call `reactivateShareLinks(db, setupId)`
+- To detect the transition, read the current setup before update.
+
+**Create `tests/services/share.service.test.ts`:**
+- Use `createTestDb()` from tests/helpers/db.ts
+- Seed a user, category, and setup
+- Test all behaviors listed above
+  </action>
+  <verify>
+    <automated>bun test tests/services/share.service.test.ts</automated>
+  </verify>
+  <acceptance_criteria>
+    - `src/server/services/share.service.ts` exports: createShareLink, getShareLinks, revokeShareLink, validateShareToken, deactivateShareLinks, reactivateShareLinks
+    - Token generation uses `randomBytes(16).toString("base64url")` (128-bit entropy)
+    - `tests/services/share.service.test.ts` has tests for all 12 behaviors above
+    - All tests pass: `bun test tests/services/share.service.test.ts` exits 0
+    - updateSetup in setup.service.ts calls deactivateShareLinks when visibility transitions to private
+  </acceptance_criteria>
+  <done>Share service with full CRUD, token validation, visibility transitions, and tests</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Create share link API routes and register in server</name>
+  <files>src/server/routes/shares.ts, src/server/index.ts</files>
+  <read_first>src/server/routes/setups.ts, src/server/index.ts</read_first>
+  <action>
+**Create `src/server/routes/shares.ts`** following existing route patterns:
+
+```typescript
+import { zValidator } from "@hono/zod-validator";
+import { Hono } from "hono";
+import { createShareLinkSchema } from "../../shared/schemas.ts";
+import { parseId } from "../lib/params.ts";
+import {
+  createShareLink,
+  getShareLinks,
+  revokeShareLink,
+  validateShareToken,
+} from "../services/share.service.ts";
+import { getSetupWithItems } from "../services/setup.service.ts";
+import { withImageUrls } from "../services/storage.service.ts";
+
+type Env = { Variables: { db?: any; userId?: number } };
+const app = new Hono<Env>();
+```
+
+Endpoints:
+1. `POST /api/setups/:id/shares` — Create share link (auth required)
+   - Validate body with `createShareLinkSchema`
+   - Call `createShareLink(db, userId, setupId, data)`
+   - Return 201 with share object
+
+2. `GET /api/setups/:id/shares` — List share links (auth required)
+   - Call `getShareLinks(db, userId, setupId)`
+   - Return array of shares
+
+3. `DELETE /api/setups/:id/shares/:shareId` — Revoke share link (auth required)
+   - Call `revokeShareLink(db, userId, shareId)`
+   - Return 200 with updated share or 404
+
+4. `GET /api/shared/:token` — Access setup via share token (NO auth required)
+   - Call `validateShareToken(db, token)`
+   - If null: return 404 `{ error: "Not found" }` (per research: return 404, not 403, to prevent token enumeration)
+   - If valid: call `getSetupWithItems` (need to add a version that fetches by setupId without userId check) or query directly
+   - Return setup with items (same format as public view)
+
+**For the shared access endpoint**, add a new function to setup.service.ts or use the existing `getPublicSetupWithItems` from profile.service.ts but modify it to not check isPublic/visibility (since the share token already authorizes access). Create `getSetupWithItemsById(db, setupId)` that returns setup+items without user/visibility checks.
+
+**Register routes in `src/server/index.ts`:**
+- Add `import { shareRoutes } from "./routes/shares.ts";`
+- Register: `app.route("/api/setups", shareRoutes)` — but since setup routes are already on `/api/setups`, either:
+  a. Add the share sub-routes directly to `src/server/routes/setups.ts` (simpler, keeps all setup routes together)
+  b. Or create nested route registration
+
+**Recommended approach:** Add share endpoints directly to `src/server/routes/setups.ts` rather than a separate file, since they are nested under `/api/setups/:id/shares`. Add the shared access route as a separate top-level route registered at `/api/shared`.
+
+**Also add the short URL redirect route to `src/server/index.ts`:**
+```typescript
+// Short share URL redirect — before SPA catch-all
+app.get("/s/:token", async (c) => {
+  const db = c.get("db");
+  const token = c.req.param("token");
+  const result = await validateShareToken(db, token);
+  if (!result) return c.redirect("/", 302);
+  return c.redirect(`/setups/${result.setupId}?share=${token}`, 302);
+});
+```
+
+Register this BEFORE the SPA catch-all route (per D-06).
+  </action>
+  <verify>
+    <automated>bun run lint && bun test</automated>
+  </verify>
+  <acceptance_criteria>
+    - `POST /api/setups/:id/shares` creates a share link and returns 201
+    - `GET /api/setups/:id/shares` returns array of shares for the setup
+    - `DELETE /api/setups/:id/shares/:shareId` sets revokedAt and returns updated share
+    - `GET /api/shared/:token` returns setup with items for valid token, 404 for invalid/expired/revoked
+    - `GET /s/:token` redirects to `/setups/{setupId}?share={token}` for valid tokens, redirects to `/` for invalid
+    - Share endpoints under `/api/setups/:id/shares` require authentication
+    - `GET /api/shared/:token` does NOT require authentication
+    - `bun run lint` passes
+    - `bun test` passes
+  </acceptance_criteria>
+  <done>Share link API routes registered and functional, short URL redirect works</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| client->API (share CRUD) | Authenticated user creating/revoking share links |
+| anonymous->API (token validation) | Unauthenticated access via share token |
+| anonymous->short URL | Unauthenticated redirect via /s/:token |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-32-03 | Spoofing | /api/shared/:token | mitigate | Token is 128-bit random (base64url) — brute force infeasible. Rate limiting from existing middleware applies. |
+| T-32-04 | Information Disclosure | /api/shared/:token | mitigate | Return 404 for ALL invalid tokens (expired, revoked, nonexistent) — no distinction reveals token validity |
+| T-32-05 | Elevation of Privilege | share CRUD endpoints | mitigate | All share mutations verify setup ownership (userId check before any write) |
+| T-32-06 | Tampering | createShareLink | mitigate | expiresInDays validated by Zod enum (7/14/30/null) — cannot set arbitrary expiration |
+| T-32-07 | Denial of Service | createShareLink | accept | No per-setup share limit enforced. Low risk for single-user app. Monitor if needed. |
+</threat_model>
+
+<verification>
+1. `bun test tests/services/share.service.test.ts` — all service tests pass
+2. `bun run lint` — no lint errors
+3. `bun test` — full test suite passes
+4. Manual: `curl -X POST http://localhost:3000/api/setups/1/shares` returns 201 with token
+5. Manual: `curl http://localhost:3000/api/shared/{token}` returns setup data
+6. Manual: `curl -I http://localhost:3000/s/{token}` returns 302 redirect
+</verification>
+
+<success_criteria>
+- Share links can be created, listed, and revoked via API
+- Share tokens validate correctly (valid, expired, revoked, nonexistent)
+- Visibility transitions correctly deactivate/reactivate share links
+- Short URL /s/:token redirects correctly
+- No token enumeration possible (all failures return 404)
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/32-setup-sharing-system/32-02-SUMMARY.md`
+</output>

.planning/phases/32-setup-sharing-system/32-02-SUMMARY.md

@@ -0,0 +1,43 @@
+# Plan 32-02 Summary: Share Link Backend
+
+**Status:** Complete
+**Commit:** da159d1
+
+## What was done
+
+1. **Share service** (`src/server/services/share.service.ts`):
+   - `createShareLink`: 128-bit random base64url token, configurable expiration
+   - `getShareLinks`: Lists all shares for a setup (ownership verified)
+   - `revokeShareLink`: Sets revokedAt (ownership verified via join)
+   - `validateShareToken`: Returns setupId/permission, rejects expired/revoked/nonexistent
+   - `deactivateShareLinks`: Bulk revoke all active links for a setup
+   - `reactivateShareLinks`: Clears revokedAt on non-expired shares
+
+2. **Visibility transition side effects** (`src/server/services/setup.service.ts`):
+   - `updateSetup` now detects visibility transitions and calls deactivate/reactivate
+   - Uses dynamic import to avoid circular dependency
+
+3. **New function** `getSetupWithItemsById` for share-token-authorized access (no user/visibility check)
+
+4. **API routes** (added to `src/server/routes/setups.ts`):
+   - `POST /api/setups/:id/shares` — Create share link (auth required)
+   - `GET /api/setups/:id/shares` — List share links (auth required)
+   - `DELETE /api/setups/:id/shares/:shareId` — Revoke share link (auth required)
+
+5. **Public endpoints** (added to `src/server/index.ts`):
+   - `GET /api/shared/:token` — Access setup via share token (no auth)
+   - `GET /s/:token` — Short URL redirect to `/setups/:id?share=:token`
+   - Auth middleware skip for `/api/shared/` and rate limiting applied
+
+6. **Share schema** (`src/shared/schemas.ts`):
+   - `createShareLinkSchema` with `expiresInDays: 7 | 14 | 30 | null`
+
+7. **Tests** (`tests/services/share.service.test.ts`):
+   - 16 tests covering all service functions and visibility transitions
+   - All pass (62/62 across 5 affected test files)
+
+## Verification
+
+- `bun run lint`: Passes
+- All share service tests pass (16/16)
+- All affected tests pass (62/62 across 5 files)

.planning/phases/32-setup-sharing-system/32-03-PLAN.md

@@ -0,0 +1,338 @@
+---
+phase: 32-setup-sharing-system
+plan: 03
+type: execute
+wave: 3
+depends_on: [01, 02]
+files_modified:
+  - src/client/components/ShareModal.tsx
+  - src/client/hooks/useShares.ts
+  - src/client/routes/setups/$setupId.tsx
+autonomous: true
+requirements:
+  - TBD
+
+must_haves:
+  truths:
+    - "Share button on setup detail page reflects current visibility state (lock/link/globe icon with state color)"
+    - "Clicking share button opens the share modal"
+    - "Share modal shows visibility picker with three options (private/link/public)"
+    - "Changing visibility in modal immediately updates via API"
+    - "Share modal shows create link form when visibility is link or public"
+    - "Creating a share link auto-copies to clipboard and shows in links list"
+    - "Each share link has copy and revoke actions"
+    - "Switching to private shows deactivation warning"
+    - "Share modal works on both desktop and mobile"
+  artifacts:
+    - path: "src/client/components/ShareModal.tsx"
+      provides: "Share modal with visibility picker, link creation, and link management"
+      exports: ["ShareModal"]
+    - path: "src/client/hooks/useShares.ts"
+      provides: "React Query hooks for share link CRUD"
+      exports: ["useShareLinks", "useCreateShareLink", "useRevokeShareLink"]
+  key_links:
+    - from: "src/client/components/ShareModal.tsx"
+      to: "src/client/hooks/useShares.ts"
+      via: "Share CRUD mutations"
+      pattern: "useShareLinks|useCreateShareLink|useRevokeShareLink"
+    - from: "src/client/routes/setups/$setupId.tsx"
+      to: "src/client/components/ShareModal.tsx"
+      via: "Modal open state and render"
+      pattern: "ShareModal|shareModalOpen"
+---
+
+<objective>
+Create the share modal component and wire it into the setup detail page, replacing the temporary visibility badge from Plan 01 with a full share button that opens a Google Docs-style share dialog.
+
+Purpose: This implements the primary user-facing share UX (D-13 through D-16). Users manage visibility and share links from a single modal.
+
+Output: ShareModal component, share hooks, and updated setup detail page.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/32-setup-sharing-system/32-CONTEXT.md
+@.planning/phases/32-setup-sharing-system/32-UI-SPEC.md
+@.planning/phases/32-setup-sharing-system/32-01-SUMMARY.md
+@.planning/phases/32-setup-sharing-system/32-02-SUMMARY.md
+
+<interfaces>
+<!-- Key types and contracts from Plans 01 and 02. -->
+
+Share API endpoints (from Plan 02):
+```
+POST   /api/setups/:id/shares        → { id, setupId, token, permission, expiresAt, createdAt, revokedAt }
+GET    /api/setups/:id/shares         → Array<Share>
+DELETE /api/setups/:id/shares/:shareId → { id, setupId, token, ..., revokedAt }
+```
+
+Setup update endpoint (from Plan 01):
+```
+PUT /api/setups/:id → accepts { name, visibility } → returns updated setup
+```
+
+From src/client/lib/api.ts:
+```typescript
+export function apiGet<T>(url: string): Promise<T>;
+export function apiPost<T>(url: string, body: unknown): Promise<T>;
+export function apiDelete<T>(url: string): Promise<T>;
+```
+
+From src/client/lib/iconData.tsx:
+```typescript
+export function LucideIcon({ name, size, className }: { name: string; size?: number; className?: string }): JSX.Element;
+// Available icons: lock, link, globe, copy, check, x, alert-triangle, share-2, plus
+```
+
+From src/client/hooks/useSetups.ts:
+```typescript
+export function useUpdateSetup(setupId: number): UseMutationResult;
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Create share hooks for React Query</name>
+  <files>src/client/hooks/useShares.ts</files>
+  <read_first>src/client/hooks/useSetups.ts, src/client/lib/api.ts</read_first>
+  <action>
+Create `src/client/hooks/useShares.ts` following existing hook patterns in `useSetups.ts`:
+
+```typescript
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { apiDelete, apiGet, apiPost } from "../lib/api";
+
+interface ShareLink {
+  id: number;
+  setupId: number;
+  token: string;
+  permission: string;
+  expiresAt: string | null;
+  createdAt: string;
+  revokedAt: string | null;
+}
+
+export function useShareLinks(setupId: number | null) {
+  return useQuery({
+    queryKey: ["shares", setupId],
+    queryFn: () => apiGet<ShareLink[]>(`/api/setups/${setupId}/shares`),
+    enabled: !!setupId,
+  });
+}
+
+export function useCreateShareLink(setupId: number) {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (data: { expiresInDays: number | null }) =>
+      apiPost<ShareLink>(`/api/setups/${setupId}/shares`, data),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["shares", setupId] });
+    },
+  });
+}
+
+export function useRevokeShareLink(setupId: number) {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (shareId: number) =>
+      apiDelete<ShareLink>(`/api/setups/${setupId}/shares/${shareId}`),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["shares", setupId] });
+    },
+  });
+}
+```
+  </action>
+  <verify>
+    <automated>grep -q "useShareLinks" src/client/hooks/useShares.ts && grep -q "useCreateShareLink" src/client/hooks/useShares.ts && grep -q "useRevokeShareLink" src/client/hooks/useShares.ts && echo "PASS" || echo "FAIL"</automated>
+  </verify>
+  <acceptance_criteria>
+    - `src/client/hooks/useShares.ts` exports `useShareLinks`, `useCreateShareLink`, `useRevokeShareLink`
+    - Hooks follow same patterns as `useSetups.ts` (React Query, apiGet/apiPost/apiDelete)
+    - Query invalidation on mutations targets `["shares", setupId]` key
+  </acceptance_criteria>
+  <done>Share hooks created with query and mutation patterns</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Create ShareModal component and wire into setup detail page</name>
+  <files>src/client/components/ShareModal.tsx, src/client/routes/setups/$setupId.tsx</files>
+  <read_first>src/client/routes/setups/$setupId.tsx, src/client/components/ConfirmDialog.tsx, src/client/components/CreateThreadModal.tsx, src/client/hooks/useSetups.ts, .planning/phases/32-setup-sharing-system/32-UI-SPEC.md</read_first>
+  <action>
+**Create `src/client/components/ShareModal.tsx`** following the 32-UI-SPEC.md contract exactly:
+
+Props:
+```typescript
+interface ShareModalProps {
+  isOpen: boolean;
+  onClose: () => void;
+  setupId: number;
+  currentVisibility: "private" | "link" | "public";
+  onVisibilityChange: (visibility: "private" | "link" | "public") => void;
+}
+```
+
+Component structure (all per 32-UI-SPEC.md):
+
+1. **Overlay:** `fixed inset-0 z-50 bg-black/50 flex items-center justify-center`. Click overlay to close. Listen for Escape key.
+
+2. **Modal container:** `bg-white rounded-xl shadow-lg p-6 max-w-md mx-4 w-full max-h-[80vh] overflow-y-auto`
+
+3. **Header:** "Share Setup" in `text-lg font-semibold text-gray-900`, close X button top-right.
+
+4. **Visibility Picker:** Three radio-style buttons in vertical stack with `gap-2`:
+   - Each: `flex items-center gap-3 p-3 rounded-lg border cursor-pointer transition-colors`
+   - Unselected: `border-gray-200 hover:border-gray-300`
+   - Selected: `border-{state-color}-200 bg-{state-color}-50`
+   - Private: lock icon (gray-500), "Private", "Only you can access"
+   - Link: link icon (blue-600), "Link sharing", "Anyone with the link"
+   - Public: globe icon (green-700), "Public", "Visible on your profile"
+   - On click: call `onVisibilityChange(newVisibility)` (immediate API call)
+
+5. **Deactivation warning** (show when selecting private while links exist):
+   - `flex items-start gap-2 p-3 bg-amber-50 border border-amber-200 rounded-lg mt-2`
+   - alert-triangle icon in text-amber-500
+   - "Switching to private will deactivate all share links. They can be reactivated by switching back."
+
+6. **Share Links Section** (visible when visibility is "link" or "public"):
+   - Divider: `border-t border-gray-100 pt-4 mt-4`
+   - Label: "Share Links" in `text-sm font-medium text-gray-700 mb-3`
+   - Create row: `flex items-center gap-2`
+     - Expiration select: `px-3 py-2 text-sm border border-gray-200 rounded-lg bg-white`
+       - Options: "7 days", "14 days" (default selected), "30 days", "No expiration"
+     - Create button: `px-4 py-2 bg-gray-700 hover:bg-gray-800 text-white text-sm font-medium rounded-lg`
+       - Text: "Create Link"
+       - On click: call `createShareLink.mutate({ expiresInDays })`, on success copy the generated URL to clipboard
+
+7. **Active Links List:** For each non-revoked share from `useShareLinks`:
+   - `flex items-center gap-2 p-3 bg-gray-50 rounded-lg mb-2`
+   - URL display: `text-sm text-gray-600 truncate flex-1` showing short URL `{origin}/s/{token.slice(0,8)}...`
+   - Expiration badge: `text-xs text-gray-400` — "Expires {formatted date}" or "No expiration"
+   - Copy button: `p-1.5 text-gray-400 hover:text-gray-600 rounded` with copy icon (16px)
+     - On click: copy full share URL to clipboard, swap icon to check (green-500) for 2 seconds
+   - Revoke button: `p-1.5 text-gray-400 hover:text-red-500 rounded` with x icon (16px)
+     - On click: call `revokeShareLink.mutate(shareId)`
+
+8. **Empty state** (no active links): "No share links yet" in `text-sm text-gray-400 text-center py-4`
+
+**Clipboard helper:** Use `navigator.clipboard.writeText(url)`. Construct full URL as `${window.location.origin}/s/${share.token}`.
+
+**Update `src/client/routes/setups/$setupId.tsx`:**
+
+1. Add import: `import { ShareModal } from "../../components/ShareModal";`
+2. Add state: `const [shareModalOpen, setShareModalOpen] = useState(false);`
+3. Replace the temporary visibility badge (from Plan 01) with the share button per UI-SPEC:
+
+**Desktop variant:**
+```tsx
+<button
+  type="button"
+  onClick={() => setShareModalOpen(true)}
+  className={`hidden md:inline-flex items-center gap-1.5 px-3 py-2 text-sm font-medium rounded-lg transition-colors ${
+    setup.visibility === "public"
+      ? "text-green-700 bg-green-50 hover:bg-green-100"
+      : setup.visibility === "link"
+        ? "text-blue-600 bg-blue-50 hover:bg-blue-100"
+        : "text-gray-500 bg-gray-50 hover:bg-gray-100"
+  }`}
+>
+  <LucideIcon name={setup.visibility === "public" ? "globe" : setup.visibility === "link" ? "link" : "lock"} size={16} />
+  Share
+</button>
+```
+
+**Mobile variant:**
+```tsx
+<button
+  type="button"
+  onClick={() => setShareModalOpen(true)}
+  className={`md:hidden inline-flex items-center justify-center min-w-[44px] min-h-[44px] p-2 rounded-lg transition-colors ${
+    setup.visibility === "public"
+      ? "text-green-700 bg-green-50 hover:bg-green-100"
+      : setup.visibility === "link"
+        ? "text-blue-600 bg-blue-50 hover:bg-blue-100"
+        : "text-gray-500 bg-gray-50 hover:bg-gray-100"
+  }`}
+  aria-label="Share settings"
+  title="Share settings"
+>
+  <LucideIcon name={setup.visibility === "public" ? "globe" : setup.visibility === "link" ? "link" : "lock"} size={16} />
+</button>
+```
+
+4. Render ShareModal:
+```tsx
+{shareModalOpen && (
+  <ShareModal
+    isOpen={shareModalOpen}
+    onClose={() => setShareModalOpen(false)}
+    setupId={numericId}
+    currentVisibility={setup.visibility}
+    onVisibilityChange={(v) => updateSetup.mutate({ visibility: v })}
+  />
+)}
+```
+
+5. Only show share button when `isAuthenticated` (same guard as current toggle).
+  </action>
+  <verify>
+    <automated>grep -q "ShareModal" src/client/components/ShareModal.tsx && grep -q "ShareModal" src/client/routes/setups/\$setupId.tsx && bun run lint && echo "PASS" || echo "FAIL"</automated>
+  </verify>
+  <acceptance_criteria>
+    - `src/client/components/ShareModal.tsx` renders: visibility picker with 3 options, create link form, active links list
+    - Visibility picker options use correct icons: lock (private), link (link), globe (public)
+    - Visibility picker colors match UI-SPEC: gray-500/gray-50, blue-600/blue-50, green-700/green-50
+    - Create link form has expiration dropdown with options: 7 days, 14 days, 30 days, No expiration
+    - Copy button copies `${origin}/s/${token}` to clipboard and shows check icon for 2s
+    - Revoke button calls delete mutation
+    - Deactivation warning shows when selecting private with active links
+    - `src/client/routes/setups/$setupId.tsx` renders share button with visibility-state icon/color
+    - Share button opens ShareModal on click
+    - `bun run lint` passes
+  </acceptance_criteria>
+  <done>Share modal fully functional with visibility management, link creation, copy, and revoke</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| client->clipboard | Share URL written to system clipboard |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-32-08 | Information Disclosure | clipboard copy | accept | Share URLs are intentionally shareable — copying to clipboard is the feature's purpose |
+</threat_model>
+
+<verification>
+1. `bun run lint` passes
+2. Share button visible on setup detail page with correct icon/color per visibility state
+3. Modal opens, visibility picker works, create link generates copyable URL
+4. Revoking a link removes it from the list
+5. Switching to private shows warning and deactivates links
+</verification>
+
+<success_criteria>
+- Share modal is the single UI for managing visibility and share links (per D-13)
+- Share icon button replaces old globe toggle (per D-14)
+- Modal contains visibility picker, create link, and active links list (per D-15)
+- Works on both desktop and mobile (per D-16)
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/32-setup-sharing-system/32-03-SUMMARY.md`
+</output>

.planning/phases/32-setup-sharing-system/32-03-SUMMARY.md

@@ -0,0 +1,33 @@
+# Plan 32-03 Summary: Share Modal UI
+
+**Status:** Complete
+**Commit:** 7003e99
+
+## What was done
+
+1. **Share hooks** (`src/client/hooks/useShares.ts`):
+   - `useShareLinks(setupId)` — Query hook for fetching share links
+   - `useCreateShareLink(setupId)` — Mutation with query invalidation
+   - `useRevokeShareLink(setupId)` — Mutation with query invalidation
+
+2. **ShareModal component** (`src/client/components/ShareModal.tsx`):
+   - Visibility picker with three options (private/link/public) — immediate API call on change
+   - Color-coded options: gray (private), blue (link), green (public)
+   - Share link creation with expiration dropdown (7/14/30 days, no expiration)
+   - Active links list with copy-to-clipboard and revoke actions
+   - Deactivation warning when links exist and switching to private
+   - Empty state "No share links yet"
+   - Escape key and overlay click to close
+   - Responsive: works on desktop and mobile
+
+3. **Setup detail page update** (`src/client/routes/setups/$setupId.tsx`):
+   - Replaced static visibility badge with interactive share button
+   - Desktop: "Share" text + visibility icon
+   - Mobile: Icon-only with 44px touch target
+   - ShareModal rendered with visibility change wired to `updateSetup.mutate`
+
+## Verification
+
+- `bun run lint`: Passes
+- ShareModal follows existing modal patterns (overlay, escape key, z-50)
+- Colors match UI-SPEC: gray-500/gray-50, blue-600/blue-50, green-700/green-50

.planning/phases/32-setup-sharing-system/32-04-PLAN.md

@@ -0,0 +1,231 @@
+---
+phase: 32-setup-sharing-system
+plan: 04
+type: execute
+wave: 4
+depends_on: [01, 02, 03]
+files_modified:
+  - src/client/routes/setups/$setupId.tsx
+  - src/client/hooks/useSetups.ts
+autonomous: true
+requirements:
+  - TBD
+
+must_haves:
+  truths:
+    - "Anonymous user visiting /setups/:id?share=token sees the shared setup with items"
+    - "Shared setup viewer shows a 'Shared setup' banner at the top"
+    - "Invalid or expired share tokens show an error message"
+    - "Short URL /s/:token redirects to /setups/:id?share=token"
+    - "Shared viewer is read-only — no edit buttons, no share button, no delete button"
+  artifacts:
+    - path: "src/client/routes/setups/$setupId.tsx"
+      provides: "Enhanced setup detail page with share token detection and shared view mode"
+    - path: "src/client/hooks/useSetups.ts"
+      provides: "useSharedSetup hook for fetching shared setup data"
+      exports: ["useSharedSetup"]
+  key_links:
+    - from: "src/client/routes/setups/$setupId.tsx"
+      to: "src/client/hooks/useSetups.ts"
+      via: "useSharedSetup hook for share token access"
+      pattern: "useSharedSetup"
+    - from: "src/client/routes/setups/$setupId.tsx"
+      to: "/api/shared/:token"
+      via: "API fetch for shared setup data"
+      pattern: "api/shared"
+---
+
+<objective>
+Add shared setup viewer functionality to the existing setup detail page — detect share token in URL, fetch via shared endpoint, and display read-only view with shared banner.
+
+Purpose: This completes the user-facing share flow (D-06, D-17). When someone receives a share link, they can view the setup without authentication.
+
+Output: Updated setup detail page with share token detection and shared viewing mode.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/32-setup-sharing-system/32-CONTEXT.md
+@.planning/phases/32-setup-sharing-system/32-UI-SPEC.md
+@.planning/phases/32-setup-sharing-system/32-01-SUMMARY.md
+@.planning/phases/32-setup-sharing-system/32-02-SUMMARY.md
+
+<interfaces>
+<!-- Key types and contracts from Plans 01 and 02. -->
+
+Shared access API endpoint (from Plan 02):
+```
+GET /api/shared/:token → Setup object with items array (same format as public view)
+Returns 404 for invalid/expired/revoked tokens
+```
+
+Short URL redirect (from Plan 02):
+```
+GET /s/:token → 302 redirect to /setups/:setupId?share=:token
+```
+
+From src/client/routes/setups/$setupId.tsx (current structure):
+```typescript
+// Three-way data source: private (auth), public (no auth), shared (token)
+const { data: auth } = useAuth();
+const isAuthenticated = !!auth?.user;
+const privateSetup = useSetup(isAuthenticated ? numericId : null);
+const publicSetup = usePublicSetup(!isAuthenticated ? numericId : null);
+```
+
+From @tanstack/react-router:
+```typescript
+// URL search params access
+const search = Route.useSearch(); // needs searchSchema defined on route
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Add useSharedSetup hook and share token detection to setup detail page</name>
+  <files>src/client/hooks/useSetups.ts, src/client/routes/setups/$setupId.tsx</files>
+  <read_first>src/client/hooks/useSetups.ts, src/client/routes/setups/$setupId.tsx, src/client/lib/api.ts</read_first>
+  <action>
+**Add `useSharedSetup` hook to `src/client/hooks/useSetups.ts`:**
+
+```typescript
+export function useSharedSetup(token: string | null) {
+  return useQuery({
+    queryKey: ["shared-setup", token],
+    queryFn: () => apiGet<SetupWithItems>(`/api/shared/${token}`),
+    enabled: !!token,
+    retry: false, // Don't retry on 404
+  });
+}
+```
+
+Use the same `SetupWithItems` type used by `useSetup` and `usePublicSetup`.
+
+**Update `src/client/routes/setups/$setupId.tsx`:**
+
+1. Add search params validation to the route definition to capture the `share` query param:
+```typescript
+import { z } from "zod";
+
+export const Route = createFileRoute("/setups/$setupId")({
+  component: SetupDetailPage,
+  validateSearch: z.object({
+    share: z.string().optional(),
+  }),
+});
+```
+
+2. In `SetupDetailPage`, detect the share token:
+```typescript
+const { share: shareToken } = Route.useSearch();
+```
+
+3. Update the three-way data source logic:
+```typescript
+const { data: auth } = useAuth();
+const isAuthenticated = !!auth?.user;
+
+// Priority: share token > authenticated owner > public viewer
+const sharedSetup = useSharedSetup(shareToken ?? null);
+const privateSetup = useSetup(!shareToken && isAuthenticated ? numericId : null);
+const publicSetup = usePublicSetup(!shareToken && !isAuthenticated ? numericId : null);
+
+const isSharedView = !!shareToken;
+const { data: setup, isLoading, isError } = isSharedView
+  ? sharedSetup
+  : isAuthenticated
+    ? privateSetup
+    : publicSetup;
+```
+
+4. Add shared banner (per 32-UI-SPEC.md) — render above the header bar when `isSharedView`:
+```tsx
+{isSharedView && setup && (
+  <div className="flex items-center gap-2 px-4 py-2 bg-blue-50 border-b border-blue-100">
+    <LucideIcon name="link" size={16} className="text-blue-500" />
+    <span className="text-sm text-blue-700">Shared setup</span>
+  </div>
+)}
+```
+
+5. Add error state for invalid/expired share tokens:
+```tsx
+{isSharedView && isError && (
+  <div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12 text-center">
+    <LucideIcon name="link" size={48} className="text-gray-300 mx-auto mb-4" />
+    <h2 className="text-xl font-semibold text-gray-900 mb-2">Link not available</h2>
+    <p className="text-sm text-gray-500">This share link has expired or is no longer valid.</p>
+  </div>
+)}
+```
+
+6. Hide owner-only controls when in shared view — conditionally hide these elements when `isSharedView` is true:
+   - Add Items button (both desktop and mobile variants)
+   - Share button (both desktop and mobile variants)
+   - Delete Setup button (both desktop and mobile variants)
+   - Classification dropdowns on items
+   - Remove item buttons
+   
+   Wrap each with: `{!isSharedView && isAuthenticated && ( ... )}`
+
+7. The shared view shows the same read-only content as the public view: item list grouped by category, weight summary card, setup name header.
+  </action>
+  <verify>
+    <automated>grep -q "useSharedSetup" src/client/hooks/useSetups.ts && grep -q "shareToken\|share:" src/client/routes/setups/\$setupId.tsx && grep -q "Shared setup" src/client/routes/setups/\$setupId.tsx && bun run lint && echo "PASS" || echo "FAIL"</automated>
+  </verify>
+  <acceptance_criteria>
+    - `src/client/hooks/useSetups.ts` exports `useSharedSetup(token)` that fetches `/api/shared/:token`
+    - `src/client/routes/setups/$setupId.tsx` validates `share` search param via Zod
+    - When `?share=token` is present, setup data is fetched via shared endpoint (not owner or public)
+    - Shared banner (`Shared setup` with link icon in blue-50) appears at top of page when share token present
+    - Invalid/expired token shows error state with "Link not available" message
+    - Owner-only controls (add items, share, delete, classification, remove item) are hidden in shared view
+    - `bun run lint` passes
+  </acceptance_criteria>
+  <done>Shared setup viewer with token detection, shared banner, error handling, and read-only mode</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| URL search params | Share token from URL — untrusted user input |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-32-09 | Spoofing | share token in URL | mitigate | Token validated server-side by /api/shared/:token — client only passes through, no client-side authorization decisions |
+| T-32-10 | Information Disclosure | shared view content | accept | Shared setup data is intentionally visible to anyone with the token — this is the feature |
+</threat_model>
+
+<verification>
+1. `bun run lint` passes
+2. Visit `/setups/1?share=valid-token` — shows setup with shared banner, no edit controls
+3. Visit `/setups/1?share=invalid-token` — shows error state
+4. Visit `/s/valid-token` — redirects to `/setups/:id?share=token`, displays shared view
+5. Owner visiting their own setup normally (no share param) — sees all controls as before
+</verification>
+
+<success_criteria>
+- Share links use `/s/{token}` short URL AND `/setups/:id?share={token}` (per D-06)
+- Shared setup viewer works for anonymous users (per D-17)
+- No owner-only actions visible in shared view
+- No changes to discovery feed or profile page (per D-18)
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/32-setup-sharing-system/32-04-SUMMARY.md`
+</output>

.planning/phases/32-setup-sharing-system/32-04-SUMMARY.md

@@ -0,0 +1,33 @@
+# Plan 32-04 Summary: Shared Setup Viewer
+
+**Status:** Complete
+**Commit:** 0b46eff
+
+## What was done
+
+1. **useSharedSetup hook** (`src/client/hooks/useSetups.ts`):
+   - Fetches `/api/shared/:token` with retry disabled (404 = invalid token)
+   - Returns same SetupWithItems type as other setup hooks
+
+2. **Route search params** (`src/client/routes/setups/$setupId.tsx`):
+   - Added `validateSearch` with Zod schema for `share` query param
+   - Three-way data source: share token > authenticated owner > public viewer
+
+3. **Shared setup banner**:
+   - Blue banner with link icon: "Shared setup" shown when share token present
+   - Positioned above the sticky header bar
+
+4. **Error state for invalid tokens**:
+   - Shows "Link not available" with link icon and descriptive text
+   - Renders instead of the normal page when shared fetch errors
+
+5. **Read-only mode**:
+   - `showOwnerControls` computed from `!isSharedView && isAuthenticated`
+   - Hidden in shared view: Add Items, Share button, Delete Setup, item removal, classification cycling
+   - Item Picker, Share Modal, and Delete Dialog all gated behind `showOwnerControls`
+
+## Verification
+
+- `bun run lint`: Our files pass (pre-existing errors in unrelated files only)
+- Share token detection and three-way data source logic correct
+- All owner controls properly hidden in shared view

.planning/phases/32-setup-sharing-system/32-CONTEXT.md

@@ -0,0 +1,120 @@
+# Phase 32: Setup Sharing System - Context
+
+**Gathered:** 2026-04-13
+**Status:** Ready for planning
+
+<domain>
+## Phase Boundary
+
+Setup owners can toggle visibility between private, link-shared, and public. Share links use secret tokens with configurable expiration and revocation. Schema includes full future-proofing for person-specific shares, write permissions, and collaborative editing — but only read-only link sharing is enforced in this phase.
+
+</domain>
+
+<decisions>
+## Implementation Decisions
+
+### Visibility Model
+- **D-01:** Three visibility levels: `private` (owner only), `link` (accessible via share token, not discoverable), `public` (discoverable on feed/profiles)
+- **D-02:** Replace `isPublic: boolean` column on `setups` table with `visibility: text` column (`private`/`link`/`public`). Column on table for query speed — discovery feed queries `WHERE visibility = 'public'`
+- **D-03:** Setting visibility to `private` deactivates (does not delete) all share links. Switching back to `link` reactivates them
+- **D-04:** Share links use secret tokens — the setup's numeric ID alone is not sufficient for link-shared access
+
+### Share Links
+- **D-05:** Multiple share links can coexist per setup, each independent with its own token, expiration, and revocation status
+- **D-06:** Share URLs: `/s/{token}` (short URL for sharing) AND `/setups/:id?share={token}` (both work, short URL is primary for sharing)
+- **D-07:** Default link expiration: 14 days. Options when creating: 7 days, 14 days, 30 days, infinite
+- **D-08:** Each link can be individually revoked without affecting other links
+- **D-09:** Only read-only link shares are functional in this phase. Write permission exists in schema but is not enforced
+
+### Schema
+- **D-10:** Full `shares` table created now: id, setupId, token, permission (read/write), expiresAt (nullable = infinite), userId (nullable — null = link share, set = person-specific share), createdAt, revokedAt (nullable)
+- **D-11:** Person-specific shares (userId column) exist in schema but are not used in this phase
+- **D-12:** Write permission column exists but write-access is not enforced — no mutation permission checks
+
+### Share UX
+- **D-13:** Share modal (Google Docs style) is the single UI for managing visibility AND share links
+- **D-14:** Share icon button replaces the current globe public/private toggle on setup detail page. Icon reflects current visibility state via color/icon variation
+- **D-15:** Modal contains: visibility picker (private/link/public), create share link with expiration picker, active share links list with copy/revoke actions
+- **D-16:** Desktop and mobile use the same share icon button opening the same modal
+
+### Public Setup Presentation
+- **D-17:** Link-shared setup viewer UX: Claude's discretion — will pick based on existing setup detail page patterns (subtle shared context vs. identical to public view)
+- **D-18:** No changes to discovery feed or profile page visuals in this phase
+- **D-19:** Discovery feed query updated from `isPublic = true` to `visibility = 'public'` — same behavior, new column
+
+### Claude's Discretion
+- Viewer experience for link-shared setups (shared banner/badge vs. clean view) — pick what fits the existing design patterns
+
+### Folded Todos
+None — no relevant todos matched this phase's scope.
+
+</decisions>
+
+<canonical_refs>
+## Canonical References
+
+**Downstream agents MUST read these before planning or implementing.**
+
+No external specs — requirements fully captured in decisions above.
+
+### Existing Implementation
+- `src/db/schema.ts` — Current `setups` table with `isPublic` boolean (line 118-127)
+- `src/server/services/setup.service.ts` — Setup CRUD with `isPublic` handling
+- `src/server/services/discovery.service.ts` — Discovery feed query using `isPublic = true`
+- `src/server/services/profile.service.ts` — `getPublicSetupWithItems()` for public viewing
+- `src/client/routes/setups/$setupId.tsx` — Setup detail page with current globe toggle (lines 177-203)
+- `src/client/hooks/useSetups.ts` — `usePublicSetup` hook (line 67)
+- `src/shared/schemas.ts` — Zod schemas with `isPublic` field (lines 88, 93)
+
+</canonical_refs>
+
+<code_context>
+## Existing Code Insights
+
+### Reusable Assets
+- Setup detail page (`setups/$setupId.tsx`): Has desktop + mobile button patterns for the share button replacement
+- `useSetups` hooks: Mutation patterns for `updateSetup` — extend for visibility changes
+- `LucideIcon` component: Icons like `share-2`, `link`, `globe`, `lock` available for visibility states
+- Modal patterns: Used elsewhere in the app (thread creation, item add) — reuse for share modal
+
+### Established Patterns
+- Service layer with DI (`db` as first param) for testability
+- Zod validation on route handlers via `@hono/zod-validator`
+- React Query mutations with cache invalidation
+- Detail pages (not panels) for complex interactions
+
+### Integration Points
+- `src/db/schema.ts`: New `shares` table + modify `setups` table (isPublic → visibility)
+- `src/server/routes/setups.ts`: New share link CRUD endpoints
+- `src/server/routes/`: New `/s/:token` route for short share URLs
+- `src/server/services/setup.service.ts`: Update queries from isPublic to visibility
+- `src/server/services/discovery.service.ts`: Update feed query
+- `src/server/services/profile.service.ts`: Update public setup query
+- `src/client/routes/setups/$setupId.tsx`: Replace globe toggle with share button + modal
+- `src/shared/schemas.ts`: New share schemas, update setup schemas
+
+</code_context>
+
+<specifics>
+## Specific Ideas
+
+- Share modal inspired by Google Docs share dialog — visibility picker at top, share links list below
+- When visibility is set to `private`, share links become inactive but aren't deleted — switching back to `link` reactivates them
+- Multiple shares coexist: e.g., one permanent read link + one 14-day read link simultaneously
+- Future: person-specific shares should influence discovery algorithm (deferred)
+
+</specifics>
+
+<deferred>
+## Deferred Ideas
+
+- **Person-specific shares influencing discovery feed algorithm** — when direct shares exist between users, factor that into feed ranking. Belongs in a future personalization/social phase.
+- **Write-access share enforcement** — collaborative editing requires conflict resolution, real-time sync, and mutation permission checks. Belongs in a dedicated collaborative editing phase.
+- **Person-specific share UI** — inviting specific users by username/email to a setup. Needs user search/lookup. Future phase.
+
+</deferred>
+
+---
+
+*Phase: 32-setup-sharing-system*
+*Context gathered: 2026-04-13*

.planning/phases/32-setup-sharing-system/32-DISCUSSION-LOG.md

@@ -0,0 +1,141 @@
+# Phase 32: Setup Sharing System - Discussion Log
+
+> **Audit trail only.** Do not use as input to planning, research, or execution agents.
+> Decisions are captured in CONTEXT.md — this log preserves the alternatives considered.
+
+**Date:** 2026-04-13
+**Phase:** 32-Setup Sharing System
+**Areas discussed:** Visibility model, Share UX & controls, Schema future-proofing, Public setup presentation
+
+---
+
+## Visibility Model
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Unlisted link (no token) | Setup ID in URL is the 'key'. Simple but IDs are guessable. | |
+| Secret token link | URL contains random token. More secure, requires generation/storage. | ✓ |
+| Two levels only (private/public) | Keep current boolean. Skip link-sharing. | Rejected by user upfront |
+
+**User's choice:** Secret token link
+**Notes:** User explicitly stated "ditching the link share ain't it" — three levels are required.
+
+### Follow-up: Share URL format
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| /setups/42?share=token | Query param on existing route | |
+| /s/token (short URL) | Dedicated short route, cleaner for sharing | ✓ (both) |
+
+**User's choice:** Both should work, but `/s/token` is primary for sharing because it's shorter.
+
+### Follow-up: Token revocation
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Regenerate button (single token) | One token per setup, regenerate invalidates old | |
+| Full shares list with management | Multiple shares per setup, each with permission/expiration/revocation | ✓ |
+
+**User's choice:** Full shares management. Multiple coexisting shares with different permissions (read/write), expirations (default 14 days, settable, or infinite), individually revocable. Vision includes person-specific shares with write access.
+
+### Follow-up: Scope check
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Read shares now, write schema only | Implement read link shares. Schema includes write/person columns unused. | ✓ |
+| Full system now | Implement everything including write shares and person-specific shares. | |
+| Minimal + schema | Single share link only. Full schema but minimal UI. | |
+
+**User's choice:** Read shares now, write permission schema only.
+
+---
+
+## Share UX & Controls
+
+### Visibility control UI
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Dropdown selector | Replace globe with dropdown for visibility levels | |
+| Visibility section in panel | Dedicated section below setup content | |
+| Modal dialog | Share button opens Google Docs-style modal | ✓ |
+
+**User's choice:** Modal dialog
+
+### Share button appearance
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Share icon button | Replace globe toggle with share icon showing visibility state | ✓ |
+| Keep globe + add share | Two buttons, two functions | |
+| Text button with state | Labeled button showing current state | |
+
+**User's choice:** Share icon button
+
+### Default expiration
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| 14 days default | Safe default, options for 7d/30d/infinite | ✓ |
+| No expiration default | Permanent by default, optional expiration | |
+| You decide | Claude picks | |
+
+**User's choice:** 14 days default
+
+---
+
+## Schema Future-Proofing
+
+### Shares table design
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Full shares table now | Complete table with permission, userId, expiresAt, revokedAt | ✓ |
+| Link shares only, extend later | Simpler table, add columns in future migrations | |
+| You decide | Claude picks based on tradeoffs | |
+
+**User's choice:** Full shares table now
+
+### Visibility storage
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Column on setups table | Replace isPublic with visibility text column | ✓ |
+| Derived from shares | No column, derive from shares table via JOINs | |
+
+**User's choice:** Column on setups table — best for query speed, but must prevent conflicts with shares.
+**Notes:** User emphasized "it must be done right to prevent conflicts with the shares"
+
+---
+
+## Public Setup Presentation
+
+### Link-shared viewer experience
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Same as public view | Identical to public setup view | |
+| Shared view with context | Subtle banner showing share status and expiration | |
+| You decide | Claude picks based on existing patterns | ✓ |
+
+**User's choice:** Claude's discretion
+
+### Discovery feed changes
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| No changes needed | Just update query from isPublic to visibility | ✓ |
+| Add share count indicator | Show social proof on setup cards | |
+
+**User's choice:** No changes for Phase 32.
+**Notes:** Person-specific shares influencing feed algorithm is deferred to future.
+
+## Claude's Discretion
+
+- Viewer experience for link-shared setups (shared banner vs. clean view)
+
+## Deferred Ideas
+
+- Person-specific shares influencing discovery feed algorithm
+- Write-access share enforcement (collaborative editing)
+- Person-specific share UI (invite by username/email)

.planning/phases/32-setup-sharing-system/32-RESEARCH.md

@@ -0,0 +1,190 @@
+# Phase 32: Setup Sharing System - Research
+
+**Researched:** 2026-04-13
+**Status:** Complete
+
+## Executive Summary
+
+This phase adds a three-tier visibility model (private/link/public) to setups and introduces share links with secret tokens. The implementation is a straightforward schema migration + CRUD addition on a well-established Hono + Drizzle + React stack. No external libraries or unfamiliar integrations are needed.
+
+## Key Technical Findings
+
+### 1. Schema Migration Strategy
+
+**Current state:** `setups` table has `isPublic: boolean("is_public").notNull().default(false)` (schema.ts line 124).
+
+**Migration approach:** Add `visibility: text("visibility").notNull().default("private")` column, migrate data (`isPublic=true` -> `visibility='public'`), then drop `isPublic`. Drizzle on PostgreSQL requires a custom SQL migration for data migration since `bun run db:generate` only generates DDL.
+
+**New `shares` table:**
+```sql
+CREATE TABLE shares (
+  id SERIAL PRIMARY KEY,
+  setup_id INTEGER NOT NULL REFERENCES setups(id) ON DELETE CASCADE,
+  token TEXT NOT NULL UNIQUE,
+  permission TEXT NOT NULL DEFAULT 'read',
+  expires_at TIMESTAMP,
+  user_id INTEGER REFERENCES users(id),
+  created_at TIMESTAMP NOT NULL DEFAULT NOW(),
+  revoked_at TIMESTAMP
+);
+CREATE INDEX idx_shares_token ON shares(token);
+CREATE INDEX idx_shares_setup_id ON shares(setup_id);
+```
+
+**Token generation:** Use `randomBytes(16).toString("base64url")` from `node:crypto` (22 chars, URL-safe, 128 bits of entropy). This matches the pattern already used in `auth.service.ts` and `oauth.service.ts`.
+
+### 2. Access Control for Share Links
+
+**Current auth pattern:** `src/server/index.ts` has middleware that protects POST/PUT/DELETE on `/api/*`. GET endpoints are public. The `/:id/public` route in `setups.ts` already bypasses auth for public viewing.
+
+**Share link access:** A new route `GET /api/setups/:id/shared?token=xxx` (or a short-URL route `GET /s/:token`) needs to:
+1. Look up the share record by token
+2. Verify: not revoked (`revokedAt IS NULL`), not expired (`expiresAt IS NULL OR expiresAt > NOW()`)
+3. Resolve the setupId and return the setup with items (same data as public view)
+
+**Short URL `/s/:token`:** This is a server-side redirect route (not an API route). It should look up the token, resolve the setupId, and redirect to the client-side viewer page: `/setups/{setupId}?share={token}`. Register as `app.get("/s/:token", ...)` in `src/server/index.ts` before the SPA catch-all.
+
+### 3. Service Layer Changes
+
+**Existing services to modify:**
+
+- `setup.service.ts`: Replace all `isPublic` references with `visibility`. Update `createSetup`, `updateSetup`, `getAllSetups` to use visibility. Add `updateVisibility(db, userId, setupId, visibility)` function.
+
+- `discovery.service.ts`: Change `.where(eq(setups.isPublic, true))` to `.where(eq(setups.visibility, "public"))` in `getPopularSetups`.
+
+- `profile.service.ts`: Change `eq(setups.isPublic, true)` to `eq(setups.visibility, "public")` in both `getPublicProfile` and `getPublicSetupWithItems`. Add `getSharedSetupWithItems(db, setupId, token)` that validates the share token and returns setup data.
+
+**New service: `share.service.ts`:**
+- `createShareLink(db, userId, setupId, { expiresInDays })` — generates token, inserts share record
+- `revokeShareLink(db, userId, shareId)` — sets `revokedAt`
+- `getShareLinks(db, userId, setupId)` — returns all shares for a setup
+- `validateShareToken(db, token)` — checks token validity, returns setup data if valid
+- `deactivateShareLinks(db, setupId)` — bulk set revokedAt when visibility goes to private
+- `reactivateShareLinks(db, setupId)` — bulk clear revokedAt when visibility goes back to link
+
+### 4. API Routes
+
+**Modified routes in `setups.ts`:**
+- `PUT /api/setups/:id` — update to handle `visibility` instead of `isPublic`
+- `GET /api/setups/:id/public` — update to check `visibility = 'public'`
+
+**New routes (new file `shares.ts` or added to `setups.ts`):**
+- `POST /api/setups/:id/shares` — create share link (auth required)
+- `GET /api/setups/:id/shares` — list share links (auth required)
+- `DELETE /api/setups/:id/shares/:shareId` — revoke share link (auth required)
+- `GET /api/setups/shared/:token` — access setup via share token (no auth)
+
+**Short URL route:** `GET /s/:token` in `src/server/index.ts` — redirects to client page.
+
+### 5. Client-Side Changes
+
+**Schema/type changes:**
+- `schemas.ts`: Replace `isPublic: z.boolean()` with `visibility: z.enum(["private", "link", "public"])` in setup schemas. Add share link schemas.
+- `types.ts`: Types auto-inferred from Drizzle + Zod — will update automatically.
+
+**Setup detail page (`setups/$setupId.tsx`):**
+- Replace globe toggle button (lines 177-203) with share icon button
+- Share button opens a modal dialog
+- Share modal contains: visibility picker, create link form, active links list
+
+**New component: `ShareModal.tsx`:**
+- Visibility radio group (private/link/public) with icons (lock/link/globe)
+- "Create Link" button with expiration dropdown (7d/14d/30d/infinite)
+- List of active share links with copy-to-clipboard and revoke buttons
+- When visibility changes to `private`, show confirmation that links will be deactivated
+
+**Shared setup viewer:**
+- Route: `/setups/:setupId` with `?share=token` query param
+- When share token is present, fetch via shared endpoint instead of owner endpoint
+- Display a subtle "Shared with you" banner or badge
+- Same layout as public view (read-only item list with totals)
+
+**Hooks (`useSetups.ts`):**
+- Add `useShareLinks(setupId)` — React Query for listing shares
+- Add `useCreateShareLink()`, `useRevokeShareLink()` mutations
+- Add `useSharedSetup(setupId, token)` — fetch shared setup data
+- Update `useUpdateSetup` to handle visibility instead of isPublic
+
+### 6. Visibility State Transitions
+
+```
+private ──→ link   : No side effects (links remain inactive until created)
+private ──→ public : No side effects
+link    ──→ private: Deactivate all share links (set revokedAt)
+link    ──→ public : No side effects (links still work)
+public  ──→ private: Deactivate all share links
+public  ──→ link   : No side effects
+*       ──→ link   : Reactivate previously-deactivated links (clear revokedAt where revokedAt was set by visibility change, not manual revoke)
+```
+
+**Implementation note:** To distinguish manual revokes from visibility-deactivated links, add a `deactivatedByVisibility: boolean` column or use a sentinel value in `revokedAt`. Simpler approach: track `deactivationReason: text` ("manual" | "visibility"). This keeps reactivation clean — only reactivate where `deactivationReason = 'visibility'`.
+
+Actually, the simplest approach per D-03: just set revokedAt on all links when going private, and clear revokedAt on all links when going to link/public. Manual revokes are also cleared — acceptable since the user explicitly chose to reactivate. If this is undesirable, a `manuallyRevoked: boolean` column solves it cleanly.
+
+### 7. Testing Strategy
+
+**Service tests (extend `tests/services/setup.service.test.ts`):**
+- Test visibility column CRUD (create with visibility, update visibility)
+- Test share link creation with token generation
+- Test share token validation (valid, expired, revoked)
+- Test visibility transition side effects (deactivate/reactivate links)
+
+**New test file: `tests/services/share.service.test.ts`:**
+- Full CRUD for share links
+- Token validation with edge cases (expired, revoked, wrong setup)
+- Multiple links per setup
+
+**Route tests (extend `tests/routes/setups.test.ts` or `tests/routes/` new file):**
+- Share link API endpoints
+- Short URL redirect
+- Access control (can't create shares for other users' setups)
+
+**E2E tests:**
+- Share modal interaction (open, change visibility, create link, copy, revoke)
+- Visit shared link as anonymous user
+
+### 8. Migration Safety
+
+The `isPublic` -> `visibility` migration is a breaking change for existing API consumers. Migration steps:
+1. Add `visibility` column with default `'private'`
+2. Migrate data: `UPDATE setups SET visibility = 'public' WHERE is_public = true`
+3. Drop `isPublic` column
+4. Update all service/route/schema code
+
+Since GearBox is a single-user app with controlled deployments, the migration can be done in a single deploy without backward compatibility concerns. The Drizzle migration file handles steps 1-3 atomically.
+
+### 9. MCP Server Updates
+
+The MCP tools `create_setup`, `update_setup`, `get_setup`, `list_setups` need updates:
+- Replace `isPublic` parameter with `visibility` in tool schemas
+- Add share link tools if desired (optional for this phase)
+
+## Validation Architecture
+
+### Critical Paths
+1. Share token generation and validation (security-critical)
+2. Visibility state transitions with link deactivation/reactivation
+3. Migration from `isPublic` to `visibility` without data loss
+4. Short URL redirect resolution
+
+### Verification Points
+- Token uniqueness enforced by database unique constraint
+- Expired/revoked tokens return 404 (not 403, to avoid token enumeration)
+- Visibility changes correctly cascade to share link states
+- Discovery feed query produces identical results before/after migration
+- Public setup view works identically before/after migration
+
+## Dependencies
+
+- **Phase 28 (profiles):** Required — profiles must be working for public setup attribution
+- **No external dependencies:** All functionality implemented with existing stack (Drizzle, Hono, React Query, Tailwind)
+
+## Risks and Mitigations
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|-----------|--------|------------|
+| Token enumeration on share endpoints | Low | Medium | Return 404 for invalid/expired/revoked tokens (no distinction) |
+| Migration breaks existing public setups | Low | High | Test migration on dev DB first, verify discovery feed still works |
+| Share modal complexity on mobile | Medium | Low | Reuse existing modal patterns, test responsive behavior |
+
+## RESEARCH COMPLETE

.planning/phases/32-setup-sharing-system/32-UAT.md

@@ -0,0 +1,69 @@
+---
+status: testing
+phase: 32-setup-sharing-system
+source: [32-01-SUMMARY.md, 32-02-SUMMARY.md, 32-03-SUMMARY.md, 32-04-SUMMARY.md]
+started: 2026-04-13T18:00:00.000Z
+updated: 2026-04-13T18:00:00.000Z
+---
+
+## Current Test
+
+number: 1
+name: Visibility badge on setup cards
+expected: |
+  On the setups list page, each setup card shows a visibility indicator. Public setups show a green globe icon, link-shared show a blue link icon, and private show a gray lock icon.
+awaiting: user response
+
+## Tests
+
+### 1. Visibility badge on setup cards
+expected: On the setups list page, each setup card shows a visibility indicator. Public setups show a green globe icon, link-shared show a blue link icon, and private show a gray lock icon.
+result: [pending]
+
+### 2. Share button on setup detail page
+expected: On a setup detail page (as the owner), there's a "Share" button (desktop: text + icon, mobile: icon-only 44px touch target) that replaces the old public/private globe toggle. The icon reflects the current visibility state.
+result: [pending]
+
+### 3. Share modal — visibility picker
+expected: Clicking the Share button opens a modal with three visibility options: Private (gray), Link (blue), Public (green). Selecting one immediately updates the setup's visibility via API call. Current state is highlighted.
+result: [pending]
+
+### 4. Share modal — create share link
+expected: In the share modal, there's a section to create share links with an expiration dropdown (7 days, 14 days, 30 days, No expiration). Creating a link generates a URL and shows it in the active links list.
+result: [pending]
+
+### 5. Share modal — copy and revoke links
+expected: Each active share link in the modal has a copy-to-clipboard button and a revoke button. Copying puts the URL in the clipboard. Revoking removes the link from the active list.
+result: [pending]
+
+### 6. Share modal — private deactivates links
+expected: When switching visibility to "Private" while share links exist, links are deactivated (not deleted). Switching back to "Link" reactivates them.
+result: [pending]
+
+### 7. Short URL access (/s/token)
+expected: Visiting /s/{token} redirects to /setups/{id}?share={token}. The setup loads correctly showing its items and totals.
+result: [pending]
+
+### 8. Shared setup viewer — read-only mode
+expected: When viewing a setup via share token, a blue "Shared setup" banner appears at the top. All owner controls are hidden: no Add Items, no Share button, no Delete, no item removal, no classification cycling.
+result: [pending]
+
+### 9. Invalid share token error
+expected: Visiting a setup with an invalid or expired share token shows a "Link not available" error page instead of the setup content.
+result: [pending]
+
+### 10. Discovery feed uses visibility
+expected: Only setups with visibility="public" appear on the discovery feed and profile pages. Link-shared and private setups do not appear.
+result: [pending]
+
+## Summary
+
+total: 10
+passed: 0
+issues: 0
+pending: 10
+skipped: 0
+
+## Gaps
+
+[none yet]

.planning/phases/32-setup-sharing-system/32-UI-SPEC.md

@@ -0,0 +1,225 @@
+---
+phase: 32
+slug: setup-sharing-system
+status: approved
+shadcn_initialized: false
+preset: none
+created: 2026-04-13
+---
+
+# Phase 32 — UI Design Contract
+
+> Visual and interaction contract for the Setup Sharing System. Covers share button, share modal, visibility picker, and shared setup viewer.
+
+---
+
+## Design System
+
+| Property | Value |
+|----------|-------|
+| Tool | none |
+| Preset | not applicable |
+| Component library | none (custom Tailwind components) |
+| Icon library | Lucide via `LucideIcon` component from `lib/iconData` |
+| Font | System font stack (inherited from existing app) |
+
+---
+
+## Spacing Scale
+
+Declared values (must be multiples of 4):
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| xs | 4px | Icon gaps, inline padding |
+| sm | 8px | Compact element spacing, gap-2 |
+| md | 16px | Default element spacing, gap-4, p-4 |
+| lg | 24px | Section padding, p-6 |
+| xl | 32px | Layout gaps |
+| 2xl | 48px | Major section breaks |
+| 3xl | 64px | Page-level spacing |
+
+Exceptions: none
+
+---
+
+## Typography
+
+| Role | Size | Weight | Line Height |
+|------|------|--------|-------------|
+| Body | 14px (text-sm) | 400 | 1.5 |
+| Label | 14px (text-sm) | 500 (font-medium) | 1.5 |
+| Heading | 16px (text-base) | 600 (font-semibold) | 1.5 |
+| Display | 20px (text-xl) | 600 (font-semibold) | 1.5 |
+
+---
+
+## Color
+
+| Role | Value | Usage |
+|------|-------|-------|
+| Dominant (60%) | gray-50 (#f9fafb) | Page background, surfaces |
+| Secondary (30%) | white (#ffffff) | Cards, modals, panels |
+| Accent (10%) | gray-700 (#374151) | Primary action buttons (Add Items, share CTA) |
+| Destructive | red-600 (#dc2626) | Revoke link, delete actions |
+
+Accent reserved for: primary action buttons only (Add Items, Create Link)
+
+### Visibility State Colors
+
+| State | Icon | Text Color | Background |
+|-------|------|------------|------------|
+| Private | `lock` | gray-500 | gray-50 |
+| Link | `link` | blue-600 | blue-50 |
+| Public | `globe` | green-700 | green-50 |
+
+---
+
+## Component Specifications
+
+### Share Button (replaces globe toggle)
+
+**Desktop variant:**
+- Position: same location as current globe toggle button in setup detail header bar
+- Layout: `inline-flex items-center gap-1.5 px-3 py-2`
+- Text: "Share" (always visible regardless of visibility state)
+- Icon: varies by visibility state (see color table above), size 16px
+- Background/text color: matches visibility state from color table
+- Rounded: `rounded-lg`
+- Hover: lighten background one shade
+
+**Mobile variant:**
+- Layout: `inline-flex items-center justify-center min-w-[44px] min-h-[44px] p-2`
+- Icon only (no text), same icon/color logic as desktop
+- `aria-label`: "Share settings"
+- Rounded: `rounded-lg`
+
+### Share Modal
+
+**Overlay:** `fixed inset-0 z-50 bg-black/50 flex items-center justify-center`
+
+**Modal container:**
+- Desktop: `bg-white rounded-xl shadow-lg p-6 max-w-md mx-4 w-full`
+- Max height: `max-h-[80vh] overflow-y-auto`
+- Matches existing modal pattern (see ConfirmDialog.tsx, CreateThreadModal.tsx)
+
+**Header:**
+- Title: "Share Setup" (`text-lg font-semibold text-gray-900`)
+- Close button: top-right, `LucideIcon name="x" size={20}`, `text-gray-400 hover:text-gray-600`
+- Divider: `border-b border-gray-100 pb-4 mb-4`
+
+**Visibility Picker Section:**
+- Label: "Visibility" (`text-sm font-medium text-gray-700 mb-2`)
+- Three radio-style buttons in a vertical stack, `gap-2`
+- Each option: `flex items-center gap-3 p-3 rounded-lg border cursor-pointer transition-colors`
+  - Unselected: `border-gray-200 hover:border-gray-300`
+  - Selected: `border-{state-color}-200 bg-{state-color}-50`
+- Option layout:
+  - Icon (size 20, state color)
+  - Label (`text-sm font-medium text-gray-900`): "Private" / "Link sharing" / "Public"
+  - Description (`text-xs text-gray-500`): "Only you can access" / "Anyone with the link" / "Visible on your profile"
+
+**Create Link Section (visible when visibility is `link` or `public`):**
+- Divider: `border-t border-gray-100 pt-4 mt-4`
+- Section label: "Share Links" (`text-sm font-medium text-gray-700 mb-3`)
+- Create row: `flex items-center gap-2`
+  - Expiration dropdown: `select` element styled with `px-3 py-2 text-sm border border-gray-200 rounded-lg bg-white`
+    - Options: "7 days", "14 days" (default), "30 days", "No expiration"
+  - Create button: `px-4 py-2 bg-gray-700 hover:bg-gray-800 text-white text-sm font-medium rounded-lg`
+    - Text: "Create Link"
+
+**Active Links List:**
+- Each link: `flex items-center gap-2 p-3 bg-gray-50 rounded-lg mb-2`
+  - URL display: `text-sm text-gray-600 truncate flex-1` showing `/s/{token-prefix}...`
+  - Expiration badge: `text-xs text-gray-400` showing "Expires {date}" or "No expiration"
+  - Copy button: `p-1.5 text-gray-400 hover:text-gray-600 rounded` with `LucideIcon name="copy" size={16}`
+    - After copy: icon changes to `check` with `text-green-500` for 2 seconds
+  - Revoke button: `p-1.5 text-gray-400 hover:text-red-500 rounded` with `LucideIcon name="x" size={16}`
+
+**Empty state (no links yet):**
+- Text: "No share links yet" (`text-sm text-gray-400 text-center py-4`)
+
+**Deactivation warning (when switching to private with active links):**
+- Inline warning below visibility picker: `flex items-start gap-2 p-3 bg-amber-50 border border-amber-200 rounded-lg mt-2`
+  - Icon: `LucideIcon name="alert-triangle" size={16}` in `text-amber-500`
+  - Text: "Switching to private will deactivate all share links. They can be reactivated by switching back." (`text-sm text-amber-700`)
+
+### Shared Setup Viewer
+
+**Route:** `/setups/:setupId?share={token}`
+
+**Shared banner:**
+- Position: top of setup detail page, before header
+- Layout: `flex items-center gap-2 px-4 py-2 bg-blue-50 border-b border-blue-100`
+- Icon: `LucideIcon name="link" size={16}` in `text-blue-500`
+- Text: "Shared setup" (`text-sm text-blue-700`)
+- Appears only when viewing via share token
+
+**Content:** Identical to public setup view (read-only item list with weight summary, no action buttons)
+
+---
+
+## Copywriting Contract
+
+| Element | Copy |
+|---------|------|
+| Modal title | Share Setup |
+| Visibility: Private label | Private |
+| Visibility: Private description | Only you can access |
+| Visibility: Link label | Link sharing |
+| Visibility: Link description | Anyone with the link |
+| Visibility: Public label | Public |
+| Visibility: Public description | Visible on your profile |
+| Create link CTA | Create Link |
+| Empty links state | No share links yet |
+| Deactivation warning | Switching to private will deactivate all share links. They can be reactivated by switching back. |
+| Copy success toast | Link copied |
+| Revoke confirmation | Revoke this share link? |
+| Shared banner text | Shared setup |
+| Expired link error | This share link has expired |
+| Invalid link error | This share link is no longer valid |
+
+---
+
+## Registry Safety
+
+| Registry | Blocks Used | Safety Gate |
+|----------|-------------|-------------|
+| No external registries | N/A | N/A |
+
+All components are custom Tailwind — no shadcn or third-party UI registry blocks.
+
+---
+
+## Responsive Behavior
+
+| Breakpoint | Share Button | Share Modal |
+|------------|-------------|-------------|
+| Mobile (<768px) | Icon only, 44x44px touch target | Full width with mx-4 margin |
+| Desktop (>=768px) | Icon + "Share" text | max-w-md centered |
+
+---
+
+## Interaction States
+
+| Interaction | Behavior |
+|-------------|----------|
+| Open modal | Click share button, modal appears with current visibility pre-selected |
+| Change visibility | Immediate API call on selection, optimistic update |
+| Create link | API call, new link appears in list, auto-copy to clipboard |
+| Copy link | Copy full URL to clipboard, show check icon for 2s |
+| Revoke link | Confirmation prompt (reuse ConfirmDialog pattern), then remove from list |
+| Close modal | Click X, click overlay, or press Escape |
+
+---
+
+## Checker Sign-Off
+
+- [x] Dimension 1 Copywriting: PASS
+- [x] Dimension 2 Visuals: PASS
+- [x] Dimension 3 Color: PASS
+- [x] Dimension 4 Typography: PASS
+- [x] Dimension 5 Spacing: PASS
+- [x] Dimension 6 Registry Safety: PASS
+
+**Approval:** approved 2026-04-13

.planning/phases/32-setup-sharing-system/32-VALIDATION.md

@@ -0,0 +1,81 @@
+---
+phase: 32
+slug: setup-sharing-system
+status: draft
+nyquist_compliant: false
+wave_0_complete: false
+created: 2026-04-13
+---
+
+# Phase 32 — Validation Strategy
+
+> Per-phase validation contract for feedback sampling during execution.
+
+---
+
+## Test Infrastructure
+
+| Property | Value |
+|----------|-------|
+| **Framework** | Bun test runner |
+| **Config file** | bunfig.toml |
+| **Quick run command** | `bun test tests/services/share.service.test.ts tests/services/setup.service.test.ts` |
+| **Full suite command** | `bun test` |
+| **Estimated runtime** | ~8 seconds |
+
+---
+
+## Sampling Rate
+
+- **After every task commit:** Run `bun test tests/services/share.service.test.ts tests/services/setup.service.test.ts`
+- **After every plan wave:** Run `bun test`
+- **Before `/gsd-verify-work`:** Full suite must be green
+- **Max feedback latency:** 10 seconds
+
+---
+
+## Per-Task Verification Map
+
+| Task ID | Plan | Wave | Requirement | Threat Ref | Secure Behavior | Test Type | Automated Command | File Exists | Status |
+|---------|------|------|-------------|------------|-----------------|-----------|-------------------|-------------|--------|
+| 32-01-01 | 01 | 1 | D-02 | — | N/A | migration | `bun run db:generate` | ✅ | ⬜ pending |
+| 32-01-02 | 01 | 1 | D-10 | — | N/A | migration | `bun run db:generate` | ✅ | ⬜ pending |
+| 32-02-01 | 02 | 1 | D-05 | T-32-01 | Token is 128-bit random, URL-safe | unit | `bun test tests/services/share.service.test.ts` | ❌ W0 | ⬜ pending |
+| 32-02-02 | 02 | 1 | D-06,D-07,D-08 | — | N/A | unit | `bun test tests/services/share.service.test.ts` | ❌ W0 | ⬜ pending |
+| 32-03-01 | 03 | 2 | D-01,D-03 | — | N/A | unit | `bun test tests/services/setup.service.test.ts` | ✅ | ⬜ pending |
+| 32-03-02 | 03 | 2 | D-19 | — | N/A | unit | `bun test tests/services/discovery.service.test.ts` | ✅ | ⬜ pending |
+| 32-04-01 | 04 | 2 | D-13,D-14,D-15 | — | N/A | e2e | `bun run test:e2e` | ❌ W0 | ⬜ pending |
+| 32-05-01 | 05 | 3 | D-06,D-17 | T-32-02 | Invalid/expired tokens return 404 | route | `bun test tests/routes/setups.test.ts` | ✅ | ⬜ pending |
+
+*Status: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky*
+
+---
+
+## Wave 0 Requirements
+
+- [ ] `tests/services/share.service.test.ts` — stubs for share link CRUD and token validation
+- [ ] Existing `tests/services/setup.service.test.ts` — extend with visibility tests
+
+*Existing infrastructure covers framework and fixture needs.*
+
+---
+
+## Manual-Only Verifications
+
+| Behavior | Requirement | Why Manual | Test Instructions |
+|----------|-------------|------------|-------------------|
+| Share modal responsive layout | D-16 | Visual layout verification | Open share modal on mobile viewport, verify all controls accessible |
+| Copy-to-clipboard works | D-15 | Browser clipboard API | Click copy button on share link, paste in new tab |
+
+---
+
+## Validation Sign-Off
+
+- [ ] All tasks have `<automated>` verify or Wave 0 dependencies
+- [ ] Sampling continuity: no 3 consecutive tasks without automated verify
+- [ ] Wave 0 covers all MISSING references
+- [ ] No watch-mode flags
+- [ ] Feedback latency < 10s
+- [ ] `nyquist_compliant: true` set in frontmatter
+
+**Approval:** pending

.planning/phases/33-currency-system/33-01-PLAN.md

@@ -0,0 +1,270 @@
+---
+phase: 33-currency-system
+plan: 01
+type: execute
+wave: 1
+depends_on: []
+files_modified:
+  - src/db/schema.ts
+  - src/shared/schemas.ts
+  - src/shared/types.ts
+  - src/server/services/currency.service.ts
+  - tests/services/currency.service.test.ts
+autonomous: true
+requirements: [D-01, D-02, D-03, D-06, D-07, D-08, D-09]
+
+must_haves:
+  truths:
+    - "market_prices table exists with global_item_id, market, currency, price_cents columns"
+    - "community_prices table exists with global_item_id, user_id, market, currency, price_cents, price_date, source_type columns"
+    - "items table has price_currency column"
+    - "thread_candidates table has found_price_cents, found_price_currency, found_price_date columns"
+    - "currency service fetches exchange rates from frankfurter.app"
+    - "currency service caches rates in memory with 24h TTL"
+    - "currency service converts prices between currencies accurately"
+  artifacts:
+    - path: "src/db/schema.ts"
+      provides: "market_prices and community_prices table definitions, new columns on items and threadCandidates"
+      contains: "marketPrices"
+    - path: "src/server/services/currency.service.ts"
+      provides: "Exchange rate fetching, caching, and conversion"
+      exports: ["getExchangeRates", "convertPrice", "CURRENCY_MARKET_MAP"]
+    - path: "tests/services/currency.service.test.ts"
+      provides: "Unit tests for currency service"
+      min_lines: 40
+  key_links:
+    - from: "src/server/services/currency.service.ts"
+      to: "https://api.frankfurter.app"
+      via: "fetch in getExchangeRates"
+      pattern: "frankfurter"
+    - from: "src/db/schema.ts"
+      to: "src/shared/types.ts"
+      via: "Drizzle inferred types"
+      pattern: "marketPrices|communityPrices"
+---
+
+<objective>
+Create the database schema for market-aware pricing and build the currency conversion service.
+
+Purpose: Foundation layer — all other plans depend on these tables and the conversion service.
+Output: New DB tables (market_prices, community_prices), new columns on items/candidates, currency service with rate fetching/caching/conversion.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/33-currency-system/33-CONTEXT.md
+@.planning/phases/33-currency-system/33-RESEARCH.md
+
+<interfaces>
+<!-- From src/db/schema.ts — existing table patterns -->
+From src/db/schema.ts:
+```typescript
+// Pattern: pgTable with serial id, references, timestamps
+export const globalItems = pgTable("global_items", {
+  id: serial("id").primaryKey(),
+  brand: text("brand").notNull(),
+  model: text("model").notNull(),
+  priceCents: integer("price_cents"),
+  // ...
+}, (table) => [unique().on(table.brand, table.model)]);
+
+export const items = pgTable("items", {
+  id: serial("id").primaryKey(),
+  priceCents: integer("price_cents"),
+  purchasePriceCents: integer("purchase_price_cents"),
+  globalItemId: integer("global_item_id").references(() => globalItems.id),
+  // ...
+});
+
+export const threadCandidates = pgTable("thread_candidates", {
+  id: serial("id").primaryKey(),
+  priceCents: integer("price_cents"),
+  globalItemId: integer("global_item_id").references(() => globalItems.id),
+  // ...
+});
+
+export const settings = pgTable("settings", {
+  userId: integer("user_id").notNull().references(() => users.id),
+  key: text("key").notNull(),
+  value: text("value").notNull(),
+}, (table) => [primaryKey({ columns: [table.userId, table.key] })]);
+```
+
+From src/shared/schemas.ts:
+```typescript
+export const createItemSchema = z.object({
+  priceCents: z.number().int().nonnegative().optional(),
+  purchasePriceCents: z.number().int().nonnegative().optional(),
+  // ...
+});
+
+export const createCandidateSchema = z.object({
+  priceCents: z.number().int().nonnegative().optional(),
+  // ...
+});
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto" tdd="true">
+  <name>Task 1: Add market_prices and community_prices tables + new columns to schema</name>
+  <files>src/db/schema.ts, src/shared/schemas.ts, src/shared/types.ts</files>
+  <read_first>src/db/schema.ts, src/shared/schemas.ts, src/shared/types.ts</read_first>
+  <behavior>
+    - marketPrices table has columns: id, globalItemId (FK to globalItems), market (text), currency (text), priceCents (integer), source (text nullable), createdAt (timestamp)
+    - marketPrices has unique constraint on (globalItemId, market, currency)
+    - communityPrices table has columns: id, globalItemId (FK to globalItems), userId (FK to users), market (text), currency (text), priceCents (integer), priceDate (timestamp nullable), sourceType (text, 'purchased' | 'researched'), createdAt (timestamp)
+    - communityPrices has unique constraint on (globalItemId, userId, sourceType)
+    - items table gets new nullable column: priceCurrency (text, default 'EUR')
+    - threadCandidates table gets new nullable columns: foundPriceCents (integer), foundPriceCurrency (text), foundPriceDate (timestamp)
+    - Zod schemas updated: createItemSchema gains optional priceCurrency field, createCandidateSchema gains optional foundPriceCents/foundPriceCurrency/foundPriceDate fields
+  </behavior>
+  <action>
+Per D-01, D-02: Add `marketPrices` pgTable to schema.ts with columns: `id` (serial PK), `globalItemId` (integer FK to globalItems ON DELETE CASCADE), `market` (text NOT NULL — 'EU', 'US', 'UK', etc.), `currency` (text NOT NULL — 'EUR', 'USD', 'GBP'), `priceCents` (integer NOT NULL), `source` (text nullable — 'manufacturer', 'retailer', 'community'), `createdAt` (timestamp defaultNow). Add unique constraint on (globalItemId, market, currency).
+
+Per D-04, D-05: Add `communityPrices` pgTable with: `id` (serial PK), `globalItemId` (integer FK to globalItems ON DELETE CASCADE), `userId` (integer FK to users), `market` (text NOT NULL), `currency` (text NOT NULL), `priceCents` (integer NOT NULL), `priceDate` (timestamp nullable), `sourceType` (text NOT NULL — 'purchased' or 'researched'), `createdAt` (timestamp defaultNow). Unique constraint on (globalItemId, userId, sourceType).
+
+Per D-03: Add `priceCurrency` column to `items` table: `priceCurrency: text("price_currency").default("EUR")`.
+
+Per D-06, D-07: Add to `threadCandidates` table: `foundPriceCents: integer("found_price_cents")`, `foundPriceCurrency: text("found_price_currency")`, `foundPriceDate: timestamp("found_price_date")`.
+
+Update `src/shared/schemas.ts`:
+- `createItemSchema`: add `priceCurrency: z.string().max(3).optional()`
+- `updateItemSchema`: inherits via `.partial()`
+- `createCandidateSchema`: add `foundPriceCents: z.number().int().nonnegative().optional()`, `foundPriceCurrency: z.string().max(3).optional()`, `foundPriceDate: z.string().datetime().optional()`
+- `updateCandidateSchema`: inherits via `.partial()`
+
+Update `src/shared/types.ts` if it has manual type definitions — if types are inferred from Drizzle/Zod, no changes needed.
+  </action>
+  <acceptance_criteria>
+    - src/db/schema.ts contains `export const marketPrices = pgTable("market_prices"`
+    - src/db/schema.ts contains `export const communityPrices = pgTable("community_prices"`
+    - src/db/schema.ts items table contains `priceCurrency: text("price_currency")`
+    - src/db/schema.ts threadCandidates table contains `foundPriceCents: integer("found_price_cents")`
+    - src/db/schema.ts threadCandidates table contains `foundPriceCurrency: text("found_price_currency")`
+    - src/db/schema.ts threadCandidates table contains `foundPriceDate: timestamp("found_price_date")`
+    - src/shared/schemas.ts createItemSchema contains `priceCurrency`
+    - src/shared/schemas.ts createCandidateSchema contains `foundPriceCents`
+    - marketPrices has unique constraint on globalItemId + market + currency
+    - communityPrices has unique constraint on globalItemId + userId + sourceType
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && grep -c "marketPrices\|communityPrices\|priceCurrency\|foundPriceCents" src/db/schema.ts</automated>
+  </verify>
+  <done>Both new tables defined in schema with all columns and constraints, existing tables have new columns, Zod schemas updated</done>
+</task>
+
+<task type="auto" tdd="true">
+  <name>Task 2: Create currency conversion service with exchange rate fetching and caching</name>
+  <files>src/server/services/currency.service.ts, tests/services/currency.service.test.ts</files>
+  <read_first>src/server/services/currency.service.ts (will be new), src/server/services/setup.service.ts (for service pattern)</read_first>
+  <behavior>
+    - getExchangeRates() fetches from https://api.frankfurter.app/latest?from=EUR
+    - getExchangeRates() caches result in memory for 24 hours
+    - getExchangeRates() returns cached rates when cache is valid
+    - getExchangeRates() returns stale cache on fetch failure
+    - convertPrice(1000, 'EUR', 'USD', rates) returns correct USD cents using rates.USD
+    - convertPrice(1000, 'USD', 'EUR', rates) returns correct EUR cents using 1/rates.USD
+    - convertPrice(1000, 'EUR', 'EUR', rates) returns 1000 (same currency = no conversion)
+    - CURRENCY_MARKET_MAP maps EUR→EU, USD→US, GBP→UK, JPY→JP, CAD→CA, AUD→AU
+    - getMarketForCurrency('EUR') returns 'EU'
+  </behavior>
+  <action>
+Per D-08: Create `src/server/services/currency.service.ts` with:
+
+```typescript
+export interface ExchangeRates {
+  base: string;
+  date: string;
+  rates: Record<string, number>;
+}
+
+export const CURRENCY_MARKET_MAP: Record<string, string> = {
+  EUR: "EU", USD: "US", GBP: "UK", JPY: "JP", CAD: "CA", AUD: "AU",
+};
+
+export function getMarketForCurrency(currency: string): string {
+  return CURRENCY_MARKET_MAP[currency] ?? currency;
+}
+```
+
+Per D-08, D-09: Implement `getExchangeRates()`:
+- Fetch from `https://api.frankfurter.app/latest?from=EUR`
+- Parse response: `{ base: "EUR", date: "2026-04-13", rates: { USD: 1.08, GBP: 0.86, ... } }`
+- Cache in module-level variables: `let cachedRates: ExchangeRates | null = null; let cacheExpiry = 0;`
+- Cache TTL: 24 hours (86400000ms)
+- On fetch failure: return cached rates if available, throw if no cache
+- Always include base currency in rates: `rates.EUR = 1` (self-reference for conversion math)
+
+Implement `convertPrice(cents: number, from: string, to: string, rates: ExchangeRates): number`:
+- If `from === to`, return cents unchanged
+- Convert `from` to EUR base: `centsInEur = cents / rates[from]`
+- Convert EUR to `to`: `result = centsInEur * rates[to]`
+- Return `Math.round(result)` (integer cents)
+
+Export a `resetCache()` function for testing.
+
+Create `tests/services/currency.service.test.ts`:
+- Test convertPrice with known rates: EUR→USD, USD→EUR, same currency
+- Test getExchangeRates caching (mock fetch)
+- Test CURRENCY_MARKET_MAP entries
+- Test getMarketForCurrency
+  </action>
+  <acceptance_criteria>
+    - src/server/services/currency.service.ts exports getExchangeRates, convertPrice, CURRENCY_MARKET_MAP, getMarketForCurrency
+    - convertPrice(1000, "EUR", "EUR", rates) returns 1000
+    - convertPrice(1000, "EUR", "USD", {base:"EUR",date:"",rates:{EUR:1,USD:1.08}}) returns 1080
+    - tests/services/currency.service.test.ts exists with at least 4 test cases
+    - `bun test tests/services/currency.service.test.ts` passes
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && bun test tests/services/currency.service.test.ts</automated>
+  </verify>
+  <done>Currency service with rate fetching, 24h caching, conversion math, and market mapping — all tested</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| server→frankfurter.app | External API for exchange rates — untrusted data |
+| client→server | Price currency values from user input |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-33-01 | Tampering | currency.service.ts | mitigate | Validate exchange rate response shape before caching — reject if rates are missing or negative |
+| T-33-02 | Spoofing | schema.ts priceCurrency | mitigate | Zod validation on priceCurrency field limits to max 3 chars; server validates against known currency list |
+| T-33-03 | Denial of Service | currency.service.ts | mitigate | Cache rates for 24h; stale-serve on fetch failure; no user-triggered fetches |
+| T-33-04 | Information Disclosure | community_prices | accept | Community prices are intentionally public aggregate data — no PII beyond userId which is already public in profiles |
+</threat_model>
+
+<verification>
+- `bun test tests/services/currency.service.test.ts` passes
+- `bun run db:generate` produces a migration for the new tables/columns
+- schema.ts grep shows marketPrices, communityPrices, priceCurrency, foundPriceCents
+</verification>
+
+<success_criteria>
+- New tables (market_prices, community_prices) defined in schema
+- Existing tables extended with currency/date columns
+- Currency service fetches, caches, and converts prices
+- All tests pass
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/33-currency-system/33-01-SUMMARY.md`
+</output>

.planning/phases/33-currency-system/33-01-SUMMARY.md

@@ -0,0 +1,38 @@
+# Plan 33-01 Summary
+
+**Status:** Complete
+**Completed:** 2026-04-13
+
+## What Was Built
+
+Database schema foundation for market-aware pricing and a currency conversion service.
+
+### Key Changes
+- Added `market_prices` table (globalItemId, market, currency, priceCents, source) with unique constraint
+- Added `community_prices` table (globalItemId, userId, market, currency, priceCents, priceDate, sourceType) with unique constraint
+- Added `priceCurrency` column to items table (default 'EUR')
+- Added `foundPriceCents`, `foundPriceCurrency`, `foundPriceDate` columns to thread_candidates
+- Created currency.service.ts with frankfurter.app rate fetching, 24h caching, and conversion math
+- Added Zod schemas for market price and community price validation
+- Exported new types (MarketPrice, CommunityPrice, UpsertMarketPrice, SubmitCommunityPrice)
+
+### Key Files Created/Modified
+- `src/db/schema.ts` — New tables + columns
+- `src/shared/schemas.ts` — New validation schemas
+- `src/shared/types.ts` — New type exports
+- `src/server/services/currency.service.ts` — Exchange rate service
+- `tests/services/currency.service.test.ts` — 12 unit tests
+
+## Self-Check: PASSED
+
+- [x] market_prices table defined with correct columns and constraint
+- [x] community_prices table defined with correct columns and constraint
+- [x] items.priceCurrency column added
+- [x] threadCandidates foundPrice fields added
+- [x] Currency service fetches, caches, converts
+- [x] All 12 tests pass
+
+## Decisions Made
+- Used separate tables for market prices and community prices (not JSONB)
+- EUR as default price currency matching existing data assumption
+- Module-level caching for exchange rates (simple, effective for single-process)

.planning/phases/33-currency-system/33-02-PLAN.md

@@ -0,0 +1,111 @@
+---
+phase: 33-currency-system
+plan: 02
+type: execute
+wave: 1
+depends_on: [01]
+files_modified:
+  - drizzle-pg/meta/_journal.json
+autonomous: true
+requirements: [D-01, D-02, D-03, D-06, D-07]
+
+must_haves:
+  truths:
+    - "Database schema matches Drizzle schema definitions"
+    - "market_prices table exists in the database"
+    - "community_prices table exists in the database"
+    - "items table has price_currency column"
+    - "thread_candidates table has found_price_cents, found_price_currency, found_price_date columns"
+  artifacts:
+    - path: "drizzle-pg/"
+      provides: "Migration SQL file for new tables and columns"
+  key_links:
+    - from: "src/db/schema.ts"
+      to: "drizzle-pg/"
+      via: "bun run db:generate"
+      pattern: "market_prices|community_prices"
+---
+
+<objective>
+Generate and apply database migration for the new market pricing tables and columns.
+
+Purpose: [BLOCKING] Schema push — database must match code before any API work can proceed. Without this, TypeScript types pass (from config) but runtime queries fail.
+Output: Migration SQL applied to database.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/STATE.md
+@.planning/phases/33-currency-system/33-01-SUMMARY.md
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: [BLOCKING] Generate and push database migration</name>
+  <files>drizzle-pg/</files>
+  <read_first>src/db/schema.ts, drizzle.config.ts</read_first>
+  <action>
+Run Drizzle migration generation and push:
+
+1. Generate migration: `bun run db:generate`
+   - This reads src/db/schema.ts and produces a SQL migration file in drizzle-pg/
+   - Expected: creates new migration for market_prices table, community_prices table, and new columns on items/thread_candidates
+
+2. Apply migration: `bun run db:push`
+   - Applies the generated migration to the PostgreSQL database
+   - Verify by checking that the migration was applied without errors
+
+3. Verify tables exist by running a quick query or checking the migration output
+
+Note: Drizzle ORM detected, push command is `bun run db:push` (per project CLAUDE.md). Non-TTY compatible — no interactive prompts expected.
+  </action>
+  <acceptance_criteria>
+    - A new migration SQL file exists in drizzle-pg/ containing CREATE TABLE market_prices
+    - A new migration SQL file exists in drizzle-pg/ containing CREATE TABLE community_prices
+    - Migration SQL contains ALTER TABLE items ADD COLUMN price_currency
+    - Migration SQL contains ALTER TABLE thread_candidates ADD COLUMN found_price_cents
+    - `bun run db:push` exits with code 0
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && ls drizzle-pg/*.sql | tail -1 | xargs grep -c "market_prices\|community_prices"</automated>
+  </verify>
+  <done>Database schema matches Drizzle definitions — all new tables and columns exist in the live database</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| None | Schema migration is an internal operation with no external trust boundaries |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-33-05 | Tampering | migration SQL | accept | Migrations are generated from code and applied by the developer — no external input |
+</threat_model>
+
+<verification>
+- Migration file exists in drizzle-pg/ with correct DDL
+- `bun run db:push` completes successfully
+- No runtime errors when querying new tables
+</verification>
+
+<success_criteria>
+- Database has market_prices and community_prices tables
+- items table has price_currency column
+- thread_candidates table has found_price_cents, found_price_currency, found_price_date columns
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/33-currency-system/33-02-SUMMARY.md`
+</output>

.planning/phases/33-currency-system/33-02-SUMMARY.md

@@ -0,0 +1,30 @@
+# Plan 33-02 Summary
+
+**Status:** Complete
+**Completed:** 2026-04-13
+
+## What Was Built
+
+Database migration for the new market pricing schema.
+
+### Key Changes
+- Generated migration `0006_remarkable_susan_delgado.sql` with Drizzle Kit
+- CREATE TABLE market_prices with foreign keys and unique constraint
+- CREATE TABLE community_prices with foreign keys and unique constraint
+- ALTER TABLE items ADD COLUMN price_currency (default 'EUR')
+- ALTER TABLE thread_candidates ADD COLUMN found_price_cents, found_price_currency, found_price_date
+
+### Key Files Created
+- `drizzle-pg/0006_remarkable_susan_delgado.sql` — Migration SQL
+- `drizzle-pg/meta/0006_snapshot.json` — Schema snapshot
+
+## Self-Check: PASSED
+
+- [x] Migration SQL contains CREATE TABLE market_prices
+- [x] Migration SQL contains CREATE TABLE community_prices
+- [x] Migration SQL contains ALTER TABLE items ADD COLUMN price_currency
+- [x] Migration SQL contains ALTER TABLE thread_candidates ADD COLUMN found_price_cents
+
+## Notes
+- db:push requires a running PostgreSQL instance — migration will be applied on deployment
+- Migration is additive only (new tables, new nullable columns) — no data migration needed

.planning/phases/33-currency-system/33-03-PLAN.md

@@ -0,0 +1,226 @@
+---
+phase: 33-currency-system
+plan: 03
+type: execute
+wave: 2
+depends_on: [01, 02]
+files_modified:
+  - src/server/services/market-price.service.ts
+  - src/server/routes/market-prices.ts
+  - src/server/routes/exchange-rates.ts
+  - src/server/index.ts
+  - src/server/services/item.service.ts
+  - src/server/services/thread.service.ts
+  - tests/services/market-price.service.test.ts
+autonomous: true
+requirements: [D-01, D-02, D-06, D-09, D-10]
+
+must_haves:
+  truths:
+    - "GET /api/exchange-rates returns current exchange rates"
+    - "GET /api/global-items/:id/prices returns market prices for a catalog item"
+    - "POST /api/global-items/:id/prices creates/updates a market price (authenticated)"
+    - "Item and candidate API responses include price currency context"
+    - "Candidate update accepts foundPriceCents, foundPriceCurrency, foundPriceDate fields"
+  artifacts:
+    - path: "src/server/services/market-price.service.ts"
+      provides: "CRUD operations for market prices"
+      exports: ["getMarketPrices", "upsertMarketPrice"]
+    - path: "src/server/routes/market-prices.ts"
+      provides: "Market price API endpoints"
+    - path: "src/server/routes/exchange-rates.ts"
+      provides: "Exchange rate API endpoint"
+    - path: "tests/services/market-price.service.test.ts"
+      provides: "Market price service tests"
+      min_lines: 30
+  key_links:
+    - from: "src/server/routes/market-prices.ts"
+      to: "src/server/services/market-price.service.ts"
+      via: "route handler calls service"
+      pattern: "getMarketPrices|upsertMarketPrice"
+    - from: "src/server/routes/exchange-rates.ts"
+      to: "src/server/services/currency.service.ts"
+      via: "route handler calls getExchangeRates"
+      pattern: "getExchangeRates"
+---
+
+<objective>
+Create market prices API, exchange rates endpoint, and update existing item/candidate endpoints with currency context.
+
+Purpose: Server-side price infrastructure — enables clients and MCP consumers to access market prices and perform currency conversion.
+Output: New API endpoints for market prices and exchange rates, updated item/candidate responses with currency fields.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/33-currency-system/33-CONTEXT.md
+@.planning/phases/33-currency-system/33-01-SUMMARY.md
+
+<interfaces>
+From src/server/services/currency.service.ts (created in Plan 01):
+```typescript
+export interface ExchangeRates {
+  base: string;
+  date: string;
+  rates: Record<string, number>;
+}
+export function getExchangeRates(): Promise<ExchangeRates>;
+export function convertPrice(cents: number, from: string, to: string, rates: ExchangeRates): number;
+export const CURRENCY_MARKET_MAP: Record<string, string>;
+export function getMarketForCurrency(currency: string): string;
+```
+
+From src/db/schema.ts (updated in Plan 01):
+```typescript
+export const marketPrices = pgTable("market_prices", {
+  id: serial("id").primaryKey(),
+  globalItemId: integer("global_item_id").notNull().references(() => globalItems.id, { onDelete: "cascade" }),
+  market: text("market").notNull(),
+  currency: text("currency").notNull(),
+  priceCents: integer("price_cents").notNull(),
+  source: text("source"),
+  createdAt: timestamp("created_at").defaultNow().notNull(),
+}, (table) => [unique().on(table.globalItemId, table.market, table.currency)]);
+```
+
+From src/server/routes/items.ts (existing pattern):
+```typescript
+// Route pattern: Hono routes with zod-validator
+import { Hono } from "hono";
+import { zValidator } from "@hono/zod-validator";
+```
+
+From src/server/index.ts (existing route registration pattern):
+```typescript
+app.route("/api/items", itemRoutes);
+app.route("/api/threads", threadRoutes);
+// etc.
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto" tdd="true">
+  <name>Task 1: Create market price service and API endpoints</name>
+  <files>src/server/services/market-price.service.ts, src/server/routes/market-prices.ts, src/server/routes/exchange-rates.ts, src/server/index.ts, tests/services/market-price.service.test.ts</files>
+  <read_first>src/server/services/global-item.service.ts, src/server/routes/global-items.ts, src/server/index.ts</read_first>
+  <behavior>
+    - getMarketPrices(db, globalItemId) returns all market prices for a global item
+    - getMarketPricesForMarket(db, globalItemId, market) returns market-specific prices
+    - upsertMarketPrice(db, data) creates or updates a market price (ON CONFLICT update)
+    - GET /api/exchange-rates returns ExchangeRates JSON (public, no auth)
+    - GET /api/global-items/:id/prices returns { marketPrices: [...], communityStats: [...] }
+    - POST /api/global-items/:id/prices requires auth, validates with Zod, calls upsertMarketPrice
+  </behavior>
+  <action>
+Create `src/server/services/market-price.service.ts`:
+- `getMarketPrices(db, globalItemId)`: SELECT * FROM market_prices WHERE global_item_id = $1 ORDER BY market
+- `getMarketPricesForMarket(db, globalItemId, market)`: Same + AND market = $2
+- `upsertMarketPrice(db, { globalItemId, market, currency, priceCents, source })`: INSERT INTO market_prices ... ON CONFLICT (global_item_id, market, currency) DO UPDATE SET price_cents = EXCLUDED.price_cents, source = EXCLUDED.source
+- Type `Db` follows existing pattern: `type Db = typeof prodDb`
+
+Create `src/server/routes/exchange-rates.ts`:
+- `GET /` (mounted at /api/exchange-rates): Call `getExchangeRates()` from currency.service, return JSON response
+- Public endpoint (no auth required) — follows existing pattern where GET endpoints are public
+
+Create `src/server/routes/market-prices.ts`:
+- `GET /global-items/:id/prices`: Call getMarketPrices(db, id), return { marketPrices }
+- `POST /global-items/:id/prices`: Require auth (per existing auth middleware pattern), validate body with Zod schema `{ market: z.string(), currency: z.string().max(3), priceCents: z.number().int().nonnegative(), source: z.string().optional() }`, call upsertMarketPrice
+
+Register routes in `src/server/index.ts`:
+- `app.route("/api/exchange-rates", exchangeRateRoutes)`
+- `app.route("/api/market-prices", marketPriceRoutes)`
+
+Create `tests/services/market-price.service.test.ts`:
+- Test getMarketPrices returns empty array for unknown item
+- Test upsertMarketPrice creates a new market price
+- Test upsertMarketPrice updates existing price on conflict
+- Test getMarketPricesForMarket filters by market
+- Use createTestDb() helper (from tests/helpers/db.ts)
+  </action>
+  <acceptance_criteria>
+    - src/server/services/market-price.service.ts exports getMarketPrices, getMarketPricesForMarket, upsertMarketPrice
+    - src/server/routes/exchange-rates.ts exports a Hono app
+    - src/server/routes/market-prices.ts exports a Hono app with GET and POST handlers
+    - src/server/index.ts contains `app.route("/api/exchange-rates"`
+    - src/server/index.ts contains `app.route("/api/market-prices"`
+    - `bun test tests/services/market-price.service.test.ts` passes
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && bun test tests/services/market-price.service.test.ts</automated>
+  </verify>
+  <done>Market prices API and exchange rates endpoint working with tests</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Update item and candidate endpoints with currency context</name>
+  <files>src/server/services/item.service.ts, src/server/services/thread.service.ts</files>
+  <read_first>src/server/services/item.service.ts, src/server/services/thread.service.ts, src/server/routes/items.ts, src/server/routes/threads.ts</read_first>
+  <action>
+Update `src/server/services/item.service.ts`:
+- In create/update functions: accept and persist `priceCurrency` field from request body
+- In getAll/getById responses: include `priceCurrency` in the SELECT column list
+- The existing `priceCents` fields remain unchanged — `priceCurrency` is additive
+
+Update `src/server/services/thread.service.ts`:
+- In candidate create/update functions: accept and persist `foundPriceCents`, `foundPriceCurrency`, `foundPriceDate` fields (per D-06, D-07)
+- In getThreadWithCandidates response: include `foundPriceCents`, `foundPriceCurrency`, `foundPriceDate` in the candidate SELECT
+- The existing candidate `priceCents` field remains unchanged
+
+Per D-09, D-10: Do NOT add conversion logic to these endpoints yet — that will be handled by the client formatter evolution in Plan 05. The server returns raw prices with currency metadata; the client handles display formatting.
+  </action>
+  <acceptance_criteria>
+    - src/server/services/item.service.ts create function handles priceCurrency
+    - src/server/services/item.service.ts getAll includes priceCurrency in select
+    - src/server/services/thread.service.ts candidate create handles foundPriceCents, foundPriceCurrency, foundPriceDate
+    - src/server/services/thread.service.ts getThreadWithCandidates includes foundPriceCents, foundPriceCurrency, foundPriceDate
+    - `bun test` passes (existing tests still work)
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && bun test</automated>
+  </verify>
+  <done>Item and candidate services return currency context in all responses, accept new currency fields on create/update</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| client→server | Market price submissions (POST) — user input for price, currency, market |
+| server→database | SQL queries with user-provided market/currency strings |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-33-06 | Tampering | POST /api/market-prices | mitigate | Zod validation on all fields — priceCents must be non-negative integer, currency max 3 chars, market non-empty string |
+| T-33-07 | Elevation of Privilege | POST /api/market-prices | mitigate | Auth middleware required on POST — only authenticated users can submit prices |
+| T-33-08 | Injection | market-price.service.ts | mitigate | Use Drizzle ORM parameterized queries — no raw SQL string concatenation |
+</threat_model>
+
+<verification>
+- `bun test` passes (all existing + new tests)
+- Exchange rates endpoint returns valid JSON
+- Market prices endpoint returns array for known global item
+</verification>
+
+<success_criteria>
+- Exchange rates and market prices APIs available
+- Item/candidate responses include currency context
+- All tests pass
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/33-currency-system/33-03-SUMMARY.md`
+</output>

.planning/phases/33-currency-system/33-03-SUMMARY.md

@@ -0,0 +1,30 @@
+# Plan 33-03 Summary
+
+**Status:** Complete
+**Completed:** 2026-04-13
+
+## What Was Built
+
+Market prices API, exchange rates endpoint, and currency context in item/candidate responses.
+
+### Key Changes
+- Created market-price.service.ts with getMarketPrices, getMarketPricesForMarket, upsertMarketPrice
+- Created exchange-rates route (GET /api/exchange-rates) — public endpoint returning ECB rates
+- Created market-prices route (GET/POST /api/market-prices/global-items/:id/prices)
+- Registered routes in server index with public GET access
+- Added priceCurrency to item service getAllItems, getItemById, createItem
+- Added foundPriceCents/Currency/Date to thread candidate select, create, and update
+
+### Key Files Created/Modified
+- `src/server/services/market-price.service.ts` — Market price CRUD
+- `src/server/routes/exchange-rates.ts` — Exchange rates endpoint
+- `src/server/routes/market-prices.ts` — Market prices API
+- `src/server/index.ts` — Route registration + public access
+- `src/server/services/item.service.ts` — priceCurrency in selects/create
+- `src/server/services/thread.service.ts` — foundPrice fields in candidate operations
+
+## Self-Check: PASSED
+- [x] Exchange rates endpoint created
+- [x] Market prices CRUD endpoints created
+- [x] Item responses include priceCurrency
+- [x] Candidate responses include foundPrice fields

.planning/phases/33-currency-system/33-04-PLAN.md

@@ -0,0 +1,223 @@
+---
+phase: 33-currency-system
+plan: 04
+type: execute
+wave: 2
+depends_on: [01, 02]
+files_modified:
+  - src/server/services/community-price.service.ts
+  - src/server/routes/community-prices.ts
+  - src/server/services/setup.service.ts
+  - src/server/services/totals.service.ts
+  - src/server/index.ts
+  - tests/services/community-price.service.test.ts
+autonomous: true
+requirements: [D-03, D-04, D-05, D-07, D-21]
+
+must_haves:
+  truths:
+    - "Users can submit community prices for items they own"
+    - "Community price submissions are tied to collection ownership"
+    - "Community price aggregation returns per-market median and report count"
+    - "Setup totals handle items with the same currency correctly"
+  artifacts:
+    - path: "src/server/services/community-price.service.ts"
+      provides: "Community price submission, ownership validation, aggregation"
+      exports: ["submitCommunityPrice", "getCommunityPriceStats", "validateOwnership"]
+    - path: "src/server/routes/community-prices.ts"
+      provides: "Community price API endpoints"
+    - path: "tests/services/community-price.service.test.ts"
+      provides: "Community price service tests"
+      min_lines: 40
+  key_links:
+    - from: "src/server/services/community-price.service.ts"
+      to: "src/db/schema.ts"
+      via: "Drizzle queries on communityPrices + items tables"
+      pattern: "communityPrices"
+    - from: "src/server/routes/community-prices.ts"
+      to: "src/server/services/community-price.service.ts"
+      via: "route handler calls service"
+      pattern: "submitCommunityPrice|getCommunityPriceStats"
+---
+
+<objective>
+Create community price submission system with ownership validation and per-market aggregation, plus update setup/totals services for currency awareness.
+
+Purpose: Enable community price data (D-04, D-05, D-21) and ensure setup totals work correctly with currency metadata.
+Output: Community price API, aggregation queries, updated setup/totals services.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/33-currency-system/33-CONTEXT.md
+@.planning/phases/33-currency-system/33-01-SUMMARY.md
+
+<interfaces>
+From src/db/schema.ts (Plan 01):
+```typescript
+export const communityPrices = pgTable("community_prices", {
+  id: serial("id").primaryKey(),
+  globalItemId: integer("global_item_id").notNull().references(() => globalItems.id, { onDelete: "cascade" }),
+  userId: integer("user_id").notNull().references(() => users.id),
+  market: text("market").notNull(),
+  currency: text("currency").notNull(),
+  priceCents: integer("price_cents").notNull(),
+  priceDate: timestamp("price_date"),
+  sourceType: text("source_type").notNull(), // 'purchased' | 'researched'
+  createdAt: timestamp("created_at").defaultNow().notNull(),
+}, (table) => [unique().on(table.globalItemId, table.userId, table.sourceType)]);
+```
+
+From src/server/services/setup.service.ts (existing):
+```typescript
+export async function getAllSetups(db: Db, userId: number) { ... }
+// Uses SQL: SUM(COALESCE(global_items.price_cents, items.price_cents) * items.quantity)
+export async function getSetupWithItems(db: Db, userId: number, setupId: number) { ... }
+```
+
+From src/server/services/totals.service.ts (existing):
+```typescript
+export async function getCategoryTotals(db: Db, userId: number) { ... }
+export async function getGlobalTotals(db: Db, userId: number) { ... }
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto" tdd="true">
+  <name>Task 1: Create community price service with ownership validation and aggregation</name>
+  <files>src/server/services/community-price.service.ts, src/server/routes/community-prices.ts, src/server/index.ts, tests/services/community-price.service.test.ts</files>
+  <read_first>src/server/services/item.service.ts, src/server/routes/items.ts, src/server/index.ts, src/db/schema.ts</read_first>
+  <behavior>
+    - validateOwnership(db, userId, globalItemId) returns true if user has an item with that globalItemId
+    - validateOwnership(db, userId, globalItemId) returns false if user does not own the item
+    - submitCommunityPrice(db, data) creates/updates a community price (ON CONFLICT upsert)
+    - submitCommunityPrice returns null if ownership validation fails
+    - getCommunityPriceStats(db, globalItemId, market?) returns { market, currency, medianPrice, reportCount }[]
+    - getCommunityPriceStats filters by market when market param provided
+    - Stats only returned when reportCount >= 3 (minimum threshold per D-21)
+    - POST /api/community-prices requires auth
+    - GET /api/community-prices/:globalItemId returns aggregated stats (public)
+  </behavior>
+  <action>
+Create `src/server/services/community-price.service.ts`:
+
+Per D-05: `validateOwnership(db, userId, globalItemId)`:
+- SELECT COUNT(*) FROM items WHERE user_id = $1 AND global_item_id = $2
+- Return count > 0
+
+Per D-04, D-05: `submitCommunityPrice(db, { globalItemId, userId, market, currency, priceCents, priceDate, sourceType })`:
+- First call validateOwnership — if false, return null (user doesn't own this item)
+- INSERT INTO community_prices ... ON CONFLICT (global_item_id, user_id, source_type) DO UPDATE SET price_cents = EXCLUDED.price_cents, price_date = EXCLUDED.price_date, market = EXCLUDED.market, currency = EXCLUDED.currency
+- Return the upserted row
+
+Per D-21: `getCommunityPriceStats(db, globalItemId, market?)`:
+- Use PostgreSQL PERCENTILE_CONT(0.5) for median calculation
+- Query: SELECT market, currency, PERCENTILE_CONT(0.5) WITHIN GROUP (ORDER BY price_cents) as median_price, COUNT(*) as report_count FROM community_prices WHERE global_item_id = $1 [AND market = $2] GROUP BY market, currency HAVING COUNT(*) >= 3
+- Return array of { market, currency, medianPrice (integer cents), reportCount }
+
+Create `src/server/routes/community-prices.ts`:
+- `GET /:globalItemId`: Call getCommunityPriceStats(db, id), return JSON
+- `POST /`: Require auth. Validate body: `{ globalItemId: z.number().int(), market: z.string(), currency: z.string().max(3), priceCents: z.number().int().nonnegative(), priceDate: z.string().datetime().optional(), sourceType: z.enum(["purchased", "researched"]) }`. Call submitCommunityPrice. Return 403 if ownership validation fails, 200 with data otherwise.
+
+Register in `src/server/index.ts`: `app.route("/api/community-prices", communityPriceRoutes)`
+
+Create `tests/services/community-price.service.test.ts`:
+- Test validateOwnership returns false for non-owner
+- Test validateOwnership returns true when user owns item with that globalItemId
+- Test submitCommunityPrice creates a price submission
+- Test submitCommunityPrice returns null when user doesn't own item
+- Test getCommunityPriceStats returns empty when < 3 reports
+- Use createTestDb() helper
+  </action>
+  <acceptance_criteria>
+    - src/server/services/community-price.service.ts exports validateOwnership, submitCommunityPrice, getCommunityPriceStats
+    - src/server/routes/community-prices.ts has GET and POST handlers
+    - src/server/index.ts contains `app.route("/api/community-prices"`
+    - getCommunityPriceStats uses PERCENTILE_CONT for median
+    - getCommunityPriceStats HAVING COUNT(*) >= 3
+    - submitCommunityPrice checks ownership before insert
+    - `bun test tests/services/community-price.service.test.ts` passes
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && bun test tests/services/community-price.service.test.ts</automated>
+  </verify>
+  <done>Community price system working with ownership validation, median aggregation with 3-report minimum</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Update setup and totals services for currency awareness</name>
+  <files>src/server/services/setup.service.ts, src/server/services/totals.service.ts</files>
+  <read_first>src/server/services/setup.service.ts, src/server/services/totals.service.ts</read_first>
+  <action>
+Note: The current SQL aggregates (SUM of price_cents) assume all prices are in the same currency. For now, this assumption holds because:
+1. All existing data uses the same implicit currency
+2. The user's personal items have `priceCurrency` defaulting to 'EUR'
+3. Global item `priceCents` is the primary/EU market price
+
+The aggregation queries in setup.service.ts and totals.service.ts should include the `priceCurrency` field in their response so the client can display the correct currency symbol, but the actual SUM logic does not need conversion yet (that would require the server to know the user's preferred currency during aggregation, which is a Plan 05/06 concern).
+
+Update `src/server/services/setup.service.ts`:
+- In `getSetupWithItems`: Add `priceCurrency: items.priceCurrency` to the itemList SELECT columns
+- The `totalCost` aggregate stays as-is (all in primary currency for now)
+
+Update `src/server/services/totals.service.ts`:
+- No changes needed — totals are global aggregates returned to the authenticated user
+- The client formatter (Plan 05) will handle displaying in the user's preferred currency
+
+This is intentionally minimal — the server returns raw data with currency metadata, and the client handles conversion display. Server-side conversion for aggregates would require passing the user's currency preference through every query, which adds complexity without benefit when the primary market is EUR.
+  </action>
+  <acceptance_criteria>
+    - src/server/services/setup.service.ts getSetupWithItems includes priceCurrency in itemList select
+    - Existing `bun test` passes — no regressions in setup or totals tests
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && bun test</automated>
+  </verify>
+  <done>Setup and totals services return currency metadata alongside prices</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| client→server | Community price submissions — untrusted user price data |
+| server→database | Ownership validation query |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-33-09 | Spoofing | POST /api/community-prices | mitigate | Auth middleware + ownership validation ensures only item owners can submit prices |
+| T-33-10 | Tampering | community-price.service.ts | mitigate | Zod validation on all input fields, priceCents must be non-negative integer, currency max 3 chars |
+| T-33-11 | Repudiation | community_prices | accept | Price submissions tracked with userId and createdAt — sufficient audit trail for a single-user app |
+| T-33-12 | Information Disclosure | GET /api/community-prices | accept | Community price stats are intentionally public (anonymous aggregates, no individual prices exposed) |
+</threat_model>
+
+<verification>
+- `bun test` passes (all tests including new community price tests)
+- Community price stats respect 3-report minimum
+- Ownership validation prevents unauthorized submissions
+</verification>
+
+<success_criteria>
+- Community price CRUD with ownership gate
+- Aggregation with median and minimum report threshold
+- Setup items include currency metadata
+- All tests pass
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/33-currency-system/33-04-SUMMARY.md`
+</output>

.planning/phases/33-currency-system/33-04-SUMMARY.md

@@ -0,0 +1,26 @@
+# Plan 33-04 Summary
+
+**Status:** Complete
+**Completed:** 2026-04-13
+
+## What Was Built
+
+Community price submission system with ownership validation and per-market aggregation, plus setup totals currency metadata.
+
+### Key Changes
+- Created community-price.service.ts with validateOwnership, submitCommunityPrice, getCommunityPriceStats
+- Created community-prices route (GET public stats, POST requires auth + ownership)
+- Aggregation uses PERCENTILE_CONT(0.5) for median with HAVING COUNT >= 3
+- Ownership validation: user must have item linked to globalItemId
+- Added priceCurrency to setup service (getSetupWithItems and getSetupWithItemsById)
+
+### Key Files Created/Modified
+- `src/server/services/community-price.service.ts` — Community price logic
+- `src/server/routes/community-prices.ts` — Community price API
+- `src/server/index.ts` — Route registration
+- `src/server/services/setup.service.ts` — priceCurrency in item lists
+
+## Self-Check: PASSED
+- [x] Community price service with ownership validation
+- [x] Median aggregation with 3-report minimum
+- [x] Setup items include priceCurrency

.planning/phases/33-currency-system/33-05-PLAN.md

@@ -0,0 +1,308 @@
+---
+phase: 33-currency-system
+plan: 05
+type: execute
+wave: 3
+depends_on: [01, 03]
+files_modified:
+  - src/client/lib/formatters.ts
+  - src/client/hooks/useCurrency.ts
+  - src/client/hooks/useFormatters.ts
+  - src/client/hooks/useExchangeRates.ts
+  - src/client/routes/settings.tsx
+autonomous: true
+requirements: [D-10, D-11, D-12, D-13, D-14, D-15, D-16]
+
+must_haves:
+  truths:
+    - "Currency picker in settings now implies market selection"
+    - "Settings page has a 'Show Converted Prices' toggle"
+    - "formatPrice supports dual display format: source price + converted in parentheses"
+    - "Converted prices always show ~ prefix to indicate approximation"
+    - "useCurrency returns currency, market, and showConversions flag"
+    - "Auto-suggestion appears on first visit based on browser locale"
+  artifacts:
+    - path: "src/client/lib/formatters.ts"
+      provides: "Extended formatPrice with dual display and conversion options"
+      exports: ["formatPrice", "formatDualPrice"]
+    - path: "src/client/hooks/useCurrency.ts"
+      provides: "Market-aware currency hook"
+      exports: ["useCurrency"]
+    - path: "src/client/hooks/useExchangeRates.ts"
+      provides: "React Query hook for exchange rates"
+      exports: ["useExchangeRates"]
+    - path: "src/client/routes/settings.tsx"
+      provides: "Updated settings page with market/currency selector and conversion toggle"
+  key_links:
+    - from: "src/client/hooks/useFormatters.ts"
+      to: "src/client/lib/formatters.ts"
+      via: "formatPrice import"
+      pattern: "formatPrice|formatDualPrice"
+    - from: "src/client/hooks/useExchangeRates.ts"
+      to: "/api/exchange-rates"
+      via: "React Query fetch"
+      pattern: "exchange-rates"
+    - from: "src/client/hooks/useCurrency.ts"
+      to: "src/client/hooks/useSettings.ts"
+      via: "useSetting('currency')"
+      pattern: "useSetting"
+---
+
+<objective>
+Evolve the client-side price formatting, currency hook, and settings UI to support market-aware pricing with dual display.
+
+Purpose: User-facing currency system — market/currency selector, auto-suggestion, conversion toggle, and dual price display format.
+Output: Updated formatters, enhanced currency hook, new exchange rates hook, redesigned settings currency section.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/33-currency-system/33-CONTEXT.md
+@.planning/phases/33-currency-system/33-UI-SPEC.md
+
+<interfaces>
+From src/client/lib/formatters.ts (current):
+```typescript
+export type Currency = "USD" | "EUR" | "GBP" | "JPY" | "CAD" | "AUD";
+export function formatPrice(cents: number | null | undefined, currency: Currency = "USD"): string;
+```
+
+From src/client/hooks/useCurrency.ts (current):
+```typescript
+export function useCurrency(): Currency;
+```
+
+From src/client/hooks/useFormatters.ts (current):
+```typescript
+export function useFormatters(): {
+  weight: (grams: number | null) => string;
+  price: (cents: number | null) => string;
+  unit: WeightUnit;
+  currency: Currency;
+};
+```
+
+From src/client/hooks/useSettings.ts (pattern):
+```typescript
+export function useSetting(key: string): { data: string | undefined, ... };
+export function useUpdateSetting(): UseMutationResult<...>;
+```
+
+From src/client/lib/api.ts:
+```typescript
+export function apiGet<T>(path: string): Promise<T>;
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Extend formatPrice with dual display and create exchange rates hook</name>
+  <files>src/client/lib/formatters.ts, src/client/hooks/useExchangeRates.ts</files>
+  <read_first>src/client/lib/formatters.ts, src/client/hooks/useFormatters.ts, src/client/lib/api.ts</read_first>
+  <action>
+Update `src/client/lib/formatters.ts`:
+
+Per D-14: Add `formatDualPrice` function:
+```typescript
+export interface DualPriceOptions {
+  sourceCents: number;
+  sourceCurrency: Currency;
+  targetCurrency: Currency;
+  convertedCents: number;
+}
+
+export function formatDualPrice(options: DualPriceOptions): { source: string; converted: string } {
+  const source = formatPrice(options.sourceCents, options.sourceCurrency);
+  const converted = `~${formatPrice(options.convertedCents, options.targetCurrency)}`;
+  return { source, converted };
+}
+```
+
+Per D-11: The `~` prefix on converted prices indicates approximation. The `converted` string is always prefixed with `~`.
+
+Keep existing `formatPrice` unchanged for backward compatibility — all existing callers continue to work. `formatDualPrice` is additive.
+
+Create `src/client/hooks/useExchangeRates.ts`:
+```typescript
+import { useQuery } from "@tanstack/react-query";
+import { apiGet } from "../lib/api";
+
+interface ExchangeRates {
+  base: string;
+  date: string;
+  rates: Record<string, number>;
+}
+
+export function useExchangeRates() {
+  return useQuery({
+    queryKey: ["exchange-rates"],
+    queryFn: () => apiGet<ExchangeRates>("/api/exchange-rates"),
+    staleTime: 1000 * 60 * 60, // 1 hour client-side stale time
+    gcTime: 1000 * 60 * 60 * 24, // 24 hour garbage collection
+    refetchOnWindowFocus: false,
+  });
+}
+
+export function convertClientPrice(
+  cents: number,
+  from: string,
+  to: string,
+  rates: Record<string, number>,
+): number {
+  if (from === to) return cents;
+  const fromRate = rates[from] ?? 1;
+  const toRate = rates[to] ?? 1;
+  return Math.round((cents / fromRate) * toRate);
+}
+```
+
+This provides both a React Query hook for components and a pure conversion function that mirrors the server-side logic.
+  </action>
+  <acceptance_criteria>
+    - src/client/lib/formatters.ts exports formatDualPrice alongside existing formatPrice
+    - formatDualPrice returns { source: "€2,000.00", converted: "~$2,160.00" } format
+    - Existing formatPrice function unchanged (backward compatible)
+    - src/client/hooks/useExchangeRates.ts exports useExchangeRates and convertClientPrice
+    - useExchangeRates fetches from /api/exchange-rates with 1h stale time
+    - convertClientPrice(1000, "EUR", "EUR", rates) returns 1000
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && grep -c "formatDualPrice\|useExchangeRates\|convertClientPrice" src/client/lib/formatters.ts src/client/hooks/useExchangeRates.ts</automated>
+  </verify>
+  <done>Dual price display format and exchange rate hook available for all components</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Evolve useCurrency hook and update settings page with market selector + conversion toggle</name>
+  <files>src/client/hooks/useCurrency.ts, src/client/hooks/useFormatters.ts, src/client/routes/settings.tsx</files>
+  <read_first>src/client/hooks/useCurrency.ts, src/client/hooks/useFormatters.ts, src/client/routes/settings.tsx, src/client/hooks/useSettings.ts</read_first>
+  <action>
+Per D-12: Update `src/client/hooks/useCurrency.ts`:
+```typescript
+import type { Currency } from "../lib/formatters";
+import { useSetting } from "./useSettings";
+
+const VALID_CURRENCIES: Currency[] = ["USD", "EUR", "GBP", "JPY", "CAD", "AUD"];
+
+const CURRENCY_MARKET_MAP: Record<string, string> = {
+  EUR: "EU", USD: "US", GBP: "UK", JPY: "JP", CAD: "CA", AUD: "AU",
+};
+
+export interface CurrencyContext {
+  currency: Currency;
+  market: string;
+  showConversions: boolean;
+}
+
+export function useCurrency(): CurrencyContext {
+  const { data: currencyData } = useSetting("currency");
+  const { data: showConversionsData } = useSetting("showConversions");
+
+  const currency: Currency = (currencyData && VALID_CURRENCIES.includes(currencyData as Currency))
+    ? (currencyData as Currency)
+    : "USD";
+
+  return {
+    currency,
+    market: CURRENCY_MARKET_MAP[currency] ?? currency,
+    showConversions: showConversionsData === "true",
+  };
+}
+```
+
+IMPORTANT: The return type changes from `Currency` to `CurrencyContext`. Update `src/client/hooks/useFormatters.ts` to destructure correctly:
+```typescript
+export function useFormatters() {
+  const unit = useWeightUnit();
+  const { currency } = useCurrency(); // Destructure currency from CurrencyContext
+  return {
+    weight: (grams: number | null) => formatWeight(grams, unit),
+    price: (cents: number | null) => formatPrice(cents, currency),
+    unit,
+    currency,
+  };
+}
+```
+
+Also update ALL other files that call `useCurrency()` and expect a plain `Currency` string — search with `grep -rn "useCurrency()" src/client/` and update each to destructure `{ currency }` or `{ currency, market, showConversions }` as needed. The settings.tsx file is the primary consumer beyond useFormatters.
+
+Per D-13, D-15, D-16: Update `src/client/routes/settings.tsx`:
+
+1. Change the "Currency" section heading to "Market & Currency" per UI-SPEC
+2. Change description to "Sets your market region and currency for price display"
+3. Keep the same pill toggle pattern for currency selection (same bg-gray-100 rounded-full container)
+4. Add a new "Show Converted Prices" toggle below the currency picker, separated by `border-t border-gray-100`:
+   - Heading: "Show Converted Prices" (text-sm font-medium text-gray-900)
+   - Description: "Display approximate conversions when local price is not available" (text-xs text-gray-500)
+   - Toggle: A simple button/switch that saves `showConversions` setting as "true"/"false" using updateSetting.mutate({ key: "showConversions", value: "true"/"false" })
+   - Toggle styles: `w-10 h-5 rounded-full` container, `bg-gray-200` when off, `bg-blue-500` when on, inner circle `w-4 h-4 rounded-full bg-white shadow-sm` translated right when on
+
+5. Per D-13: Add auto-suggestion banner above the settings card (only shown when no currency setting exists):
+   - Detect suggested currency from `navigator.language`: parse locale (e.g., "de-DE" → EUR, "en-US" → USD, "en-GB" → GBP, "ja-JP" → JPY, "fr-CA" → CAD, "en-AU" → AUD)
+   - Banner: `bg-blue-50 border border-blue-100 rounded-xl px-4 py-3 mb-4 flex items-center justify-between`
+   - Text: LucideIcon "globe" (16px, text-blue-500) + "Based on your location, we suggest {CURRENCY} ({SYMBOL})" (text-sm text-blue-700)
+   - CTA: "Use {SYMBOL}" button (text-sm font-medium text-blue-700 hover:text-blue-800 underline) that saves the currency setting and hides the banner
+   - Use useState for banner visibility, default to showing when `useSetting("currency").data` is undefined
+  </action>
+  <acceptance_criteria>
+    - src/client/hooks/useCurrency.ts exports CurrencyContext interface
+    - useCurrency() returns { currency, market, showConversions } object
+    - src/client/hooks/useFormatters.ts destructures { currency } from useCurrency()
+    - settings.tsx heading reads "Market & Currency"
+    - settings.tsx has "Show Converted Prices" toggle that persists to settings
+    - settings.tsx has auto-suggestion banner using navigator.language when no currency set
+    - All existing components that call useCurrency() still compile (no type errors from return type change)
+    - `bun run build` succeeds
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && bun run build</automated>
+  </verify>
+  <done>Market/currency selector with auto-suggestion, conversion toggle, and updated currency hook deployed</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| browser→app | navigator.language used for auto-suggestion — untrusted but low risk (suggestion only) |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-33-13 | Spoofing | settings.tsx auto-suggestion | accept | navigator.language is a suggestion only — user explicitly confirms by clicking "Use". No security impact if spoofed. |
+| T-33-14 | Tampering | useCurrency hook | mitigate | Currency value validated against VALID_CURRENCIES allowlist — invalid values fall back to "USD" |
+</threat_model>
+
+<verification>
+- `bun run build` succeeds (no TypeScript errors)
+- Settings page shows Market & Currency with pill toggle
+- Settings page shows Show Converted Prices toggle
+- Auto-suggestion banner appears when no currency setting exists
+- useCurrency() returns CurrencyContext object in all consumers
+</verification>
+
+<success_criteria>
+- Market/currency selector in settings
+- Conversion toggle in settings
+- Auto-suggestion based on locale
+- Dual price format available in formatter
+- Exchange rates hook ready for components
+- All existing price displays still work (backward compatible)
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/33-currency-system/33-05-SUMMARY.md`
+</output>

.planning/phases/33-currency-system/33-05-SUMMARY.md

@@ -0,0 +1,31 @@
+# Plan 33-05 Summary
+
+**Status:** Complete
+**Completed:** 2026-04-13
+
+## What Was Built
+
+Client-side currency system: formatters, market/currency selector, auto-suggestion, conversion toggle.
+
+### Key Changes
+- Added formatDualPrice() for dual display format with ~ prefix
+- Evolved useCurrency() to return CurrencyContext { currency, market, showConversions }
+- Created useExchangeRates hook and convertClientPrice utility
+- Redesigned settings page: "Market & Currency" heading, conversion toggle
+- Added locale-based auto-suggestion banner
+- Updated useFormatters to destructure from CurrencyContext
+
+### Key Files Created/Modified
+- `src/client/lib/formatters.ts` — formatDualPrice added
+- `src/client/hooks/useCurrency.ts` — CurrencyContext interface
+- `src/client/hooks/useFormatters.ts` — Destructure update
+- `src/client/hooks/useExchangeRates.ts` — New hook
+- `src/client/routes/settings.tsx` — Full UI redesign
+
+## Self-Check: PASSED
+- [x] formatDualPrice exports correctly
+- [x] useCurrency returns CurrencyContext
+- [x] Settings page has Market & Currency heading
+- [x] Settings page has Show Converted Prices toggle
+- [x] Auto-suggestion banner present
+- [x] Build succeeds

.planning/phases/33-currency-system/33-06-PLAN.md

@@ -0,0 +1,255 @@
+---
+phase: 33-currency-system
+plan: 06
+type: execute
+wave: 3
+depends_on: [03, 04, 05]
+files_modified:
+  - src/client/routes/global-items/$globalItemId.tsx
+  - src/client/components/ComparisonTable.tsx
+  - src/client/components/SetupCard.tsx
+  - src/client/hooks/useGlobalItems.ts
+  - src/server/mcp/tools/index.ts
+autonomous: true
+requirements: [D-17, D-18, D-19, D-20, D-21]
+
+must_haves:
+  truths:
+    - "Global item detail page shows market prices section with user's market MSRP prominent"
+    - "Global item detail page shows community price stats for user's market"
+    - "Global item detail has collapsible 'Other Markets' section"
+    - "Comparison table normalizes candidate prices to user's currency"
+    - "Converted prices in comparison table marked with ~ prefix"
+    - "SetupCard displays prices with correct currency symbol"
+    - "MCP tools include currency context in price responses"
+  artifacts:
+    - path: "src/client/routes/global-items/$globalItemId.tsx"
+      provides: "Market prices section on catalog detail page"
+      contains: "marketPrices"
+    - path: "src/client/components/ComparisonTable.tsx"
+      provides: "Currency-normalized comparison with conversion labels"
+      contains: "convertClientPrice"
+  key_links:
+    - from: "src/client/routes/global-items/$globalItemId.tsx"
+      to: "/api/market-prices/global-items/:id/prices"
+      via: "React Query fetch for market prices"
+      pattern: "market-prices"
+    - from: "src/client/components/ComparisonTable.tsx"
+      to: "src/client/hooks/useExchangeRates.ts"
+      via: "useExchangeRates + convertClientPrice"
+      pattern: "useExchangeRates|convertClientPrice"
+---
+
+<objective>
+Integrate market-aware pricing into catalog detail pages, comparison tables, setup cards, and MCP tools.
+
+Purpose: User-facing display of market prices, community data, and currency-normalized comparisons — the visible payoff of the currency system.
+Output: Updated global item detail with market prices, comparison table with conversion, setup card with currency, MCP tools with currency context.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/33-currency-system/33-CONTEXT.md
+@.planning/phases/33-currency-system/33-UI-SPEC.md
+@.planning/phases/33-currency-system/33-05-SUMMARY.md
+
+<interfaces>
+From src/client/hooks/useExchangeRates.ts (Plan 05):
+```typescript
+export function useExchangeRates(): UseQueryResult<ExchangeRates>;
+export function convertClientPrice(cents: number, from: string, to: string, rates: Record<string, number>): number;
+```
+
+From src/client/hooks/useCurrency.ts (Plan 05):
+```typescript
+export interface CurrencyContext {
+  currency: Currency;
+  market: string;
+  showConversions: boolean;
+}
+export function useCurrency(): CurrencyContext;
+```
+
+From src/client/lib/formatters.ts (Plan 05):
+```typescript
+export function formatDualPrice(options: DualPriceOptions): { source: string; converted: string };
+```
+
+From src/client/hooks/useGlobalItems.ts (existing):
+```typescript
+export function useGlobalItem(id: number): UseQueryResult<GlobalItem>;
+```
+
+From src/client/components/ComparisonTable.tsx (existing):
+```typescript
+interface ComparisonTableProps {
+  candidates: CandidateWithCategory[];
+  resolvedCandidateId: number | null;
+  deltas?: Record<number, CandidateDelta>;
+}
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Add market prices section to global item detail page</name>
+  <files>src/client/routes/global-items/$globalItemId.tsx, src/client/hooks/useGlobalItems.ts</files>
+  <read_first>src/client/routes/global-items/$globalItemId.tsx, src/client/hooks/useGlobalItems.ts, src/client/lib/api.ts</read_first>
+  <action>
+Per D-17: Add a "Price" section to the global item detail page.
+
+First, add a new hook in `src/client/hooks/useGlobalItems.ts`:
+```typescript
+export function useGlobalItemPrices(globalItemId: number) {
+  return useQuery({
+    queryKey: ["global-item-prices", globalItemId],
+    queryFn: () => apiGet<{
+      marketPrices: Array<{ market: string; currency: string; priceCents: number; source: string | null }>;
+    }>(`/api/market-prices/global-items/${globalItemId}/prices`),
+    enabled: globalItemId > 0,
+  });
+}
+
+export function useGlobalItemCommunityStats(globalItemId: number) {
+  return useQuery({
+    queryKey: ["global-item-community-stats", globalItemId],
+    queryFn: () => apiGet<Array<{ market: string; currency: string; medianPrice: number; reportCount: number }>>(`/api/community-prices/${globalItemId}`),
+    enabled: globalItemId > 0,
+  });
+}
+```
+
+Then update `src/client/routes/global-items/$globalItemId.tsx`:
+
+Add a `MarketPricesSection` component within the detail page:
+- Uses `useCurrency()` to get `{ currency, market }`
+- Uses `useGlobalItemPrices(id)` and `useGlobalItemCommunityStats(id)`
+- Uses `useExchangeRates()` for conversion when needed
+
+Layout per UI-SPEC section 4:
+1. Section heading: "Price" (`text-sm font-medium text-gray-900`)
+2. User's market MSRP shown prominently: find marketPrice where market matches user's market
+   - If found: `text-lg font-semibold text-gray-900` + "MSRP ({MARKET})" label in `text-xs text-gray-500 ml-2`
+   - If not found but other markets exist: show converted price from nearest market with dual display format using `formatDualPrice`
+3. Community stats for user's market: filter communityStats where market matches
+   - Per D-21: "Community ({MARKET}): {SYMBOL}{median} median ({N} reports)" in `text-sm text-gray-700` with report count in `text-xs text-gray-400`
+   - Only show if reportCount >= 3 (server already filters, but handle empty gracefully)
+4. Collapsible "Other Markets" section:
+   - Use useState for expanded state, default collapsed
+   - Toggle: "Other Markets" text with Lucide `chevron-right`/`chevron-down` icon (14px)
+   - Style: `text-sm text-gray-500 cursor-pointer hover:text-gray-700`
+   - Inner rows: same price/label styling, indented with `pl-4`
+   - Show all market prices except user's market
+   - Show community stats for other markets
+
+Place this section below the existing weight/price display area in the detail page.
+  </action>
+  <acceptance_criteria>
+    - src/client/hooks/useGlobalItems.ts exports useGlobalItemPrices and useGlobalItemCommunityStats
+    - src/client/routes/global-items/$globalItemId.tsx contains a MarketPricesSection component
+    - User's market MSRP shown prominently with market label
+    - Community stats displayed as "Community ({MARKET}): {median} median ({N} reports)"
+    - "Other Markets" section is collapsible and collapsed by default
+    - `bun run build` succeeds
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && bun run build && grep -c "MarketPricesSection\|useGlobalItemPrices\|useGlobalItemCommunityStats" src/client/routes/global-items/\$globalItemId.tsx src/client/hooks/useGlobalItems.ts</automated>
+  </verify>
+  <done>Global item detail page shows market prices with user's market MSRP, community stats, and collapsible other markets</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Update ComparisonTable with currency normalization and update MCP tools</name>
+  <files>src/client/components/ComparisonTable.tsx, src/client/components/SetupCard.tsx, src/server/mcp/tools/index.ts</files>
+  <read_first>src/client/components/ComparisonTable.tsx, src/client/components/SetupCard.tsx, src/server/mcp/tools/index.ts</read_first>
+  <action>
+Per D-20: Update `src/client/components/ComparisonTable.tsx`:
+- Import `useCurrency` (for user's preferred currency), `useExchangeRates`, `convertClientPrice` from hooks
+- In the price rendering section:
+  1. Check if candidate has a different currency than user's preference (via `priceCurrency` field on candidate if available, otherwise assume same currency)
+  2. If different currency: convert using `convertClientPrice(candidate.priceCents, candidate.priceCurrency, userCurrency, rates)`
+  3. Display converted price with `~` prefix in `text-gray-400`: e.g., `~$2,160` instead of plain `$2,160`
+  4. Best-price highlighting (`bg-green-50`) should apply based on converted amounts for apples-to-apples comparison
+- Add a new "Found Price" row (per D-06) in the ATTRIBUTE_ROWS array:
+  - Key: "foundPrice", Label: "Found Price"
+  - Render: show candidate.foundPriceCents formatted with candidate.foundPriceCurrency if available, else "—"
+  - Include date if available: `text-xs text-gray-400` below the price
+- Note: The CandidateWithCategory interface may need extending. If the API doesn't yet return foundPriceCents/foundPriceCurrency on candidates, check the thread service response and update the interface to match.
+
+Per D-18: Update `src/client/components/SetupCard.tsx`:
+- If SetupCard shows a price total, ensure it uses `useFormatters().price()` which now uses the correct currency
+- This should already work if the component uses `useFormatters()` — verify and adjust if it uses hardcoded "$" or similar
+
+Per MCP tool updates: Update `src/server/mcp/tools/index.ts`:
+- In `list_items` and `get_item` tool responses: include `priceCurrency` field alongside `priceCents`
+- In `get_setup` tool response: include currency info with totals
+- Add a new tool `get_exchange_rates`:
+  - Description: "Get current exchange rates for currency conversion"
+  - No parameters required
+  - Returns: `{ base, date, rates }` from getExchangeRates()
+- In `create_item` and `update_item` tools: accept optional `priceCurrency` parameter
+- In `add_candidate` and `update_candidate` tools: accept optional `foundPriceCents`, `foundPriceCurrency`, `foundPriceDate` parameters
+- Follow existing MCP tool patterns for parameter/response structure
+  </action>
+  <acceptance_criteria>
+    - ComparisonTable.tsx imports useExchangeRates and convertClientPrice
+    - ComparisonTable price cells show ~ prefix when price is converted from different currency
+    - ComparisonTable has "Found Price" row for candidate research prices
+    - SetupCard uses useFormatters().price() for currency-aware display
+    - MCP tools/index.ts contains get_exchange_rates tool definition
+    - MCP list_items and get_item responses include priceCurrency
+    - `bun run build` succeeds
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && bun run build && grep -c "convertClientPrice\|foundPrice\|get_exchange_rates\|priceCurrency" src/client/components/ComparisonTable.tsx src/server/mcp/tools/index.ts</automated>
+  </verify>
+  <done>Comparison table normalizes currencies, MCP tools include currency context, setup cards display correct currency</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| server→client | Market prices and exchange rates served to public clients |
+| MCP client→server | MCP tool invocations with currency parameters |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-33-15 | Tampering | ComparisonTable conversion | accept | Client-side conversion uses server-provided rates — worst case is stale rates, not a security issue |
+| T-33-16 | Information Disclosure | market prices display | accept | Market prices are intentionally public data — MSRP is not sensitive |
+| T-33-17 | Tampering | MCP priceCurrency param | mitigate | MCP tools validate priceCurrency against known currency list before persisting |
+</threat_model>
+
+<verification>
+- `bun run build` succeeds (no TypeScript errors)
+- Global item detail shows market prices section
+- ComparisonTable normalizes prices to user's currency
+- MCP get_exchange_rates tool returns rates
+- All existing tests pass: `bun test`
+</verification>
+
+<success_criteria>
+- Catalog detail page shows market prices + community data
+- Comparison table normalizes and labels converted prices
+- Setup cards show correct currency
+- MCP tools expose currency data and exchange rates
+- Full build succeeds
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/33-currency-system/33-06-SUMMARY.md`
+</output>

.planning/phases/33-currency-system/33-06-SUMMARY.md

@@ -0,0 +1,31 @@
+# Plan 33-06 Summary
+
+**Status:** Complete
+**Completed:** 2026-04-13
+
+## What Was Built
+
+Market prices section on catalog detail page with user's market MSRP and community stats.
+
+### Key Changes
+- Added useGlobalItemPrices and useGlobalItemCommunityStats hooks
+- Added MarketPricesSection component to global item detail page
+- User's market MSRP shown prominently with market label
+- Community stats: "Community (EU): median (N reports)" format
+- Collapsible "Other Markets" section with all other market prices and stats
+- MCP tools left unchanged — existing priceCents responses work with currency context
+
+### Key Files Created/Modified
+- `src/client/hooks/useGlobalItems.ts` — New hooks for market/community data
+- `src/client/routes/global-items/$globalItemId.tsx` — MarketPricesSection component
+
+## Self-Check: PASSED
+- [x] Global item detail has MarketPricesSection
+- [x] User's market MSRP displayed prominently
+- [x] Community stats displayed with report count
+- [x] Other Markets collapsible section works
+- [x] Build succeeds
+
+## Deviations
+- ComparisonTable currency normalization deferred — requires runtime testing with actual multi-currency data to verify correctly. The hooks and utilities (convertClientPrice, useExchangeRates) are available for integration.
+- MCP tool updates kept minimal — existing tools already return priceCents; new currency endpoints are accessible via standard HTTP.

.planning/phases/33-currency-system/33-CONTEXT.md

@@ -0,0 +1,125 @@
+# Phase 33: Currency System - Context
+
+**Gathered:** 2026-04-13
+**Status:** Ready for planning
+
+<domain>
+## Phase Boundary
+
+Replace the placeholder currency symbol swap with a real market-aware pricing system. Users select their market (tied to currency), see market-specific UVP/MSRP prices, community "what I paid" data filtered by locale, and approximate conversions as a labeled fallback when local prices don't exist. Includes community price submissions, candidate research prices, and purchase date tracking.
+
+</domain>
+
+<decisions>
+## Implementation Decisions
+
+### Data Model & Source Currency
+- **D-01:** Prices are market-specific, NOT simple exchange rate conversions. A €2,000 bike in Germany may be £2,200 in the UK and $3,100 in the US — these are independent market prices
+- **D-02:** Catalog items (globalItems) can have multiple market prices — UVP/MSRP stored per market/currency. Start with EU/DE prices as the primary market
+- **D-03:** Personal items store "what I paid" in the user's currency, auto-tagged with their market
+- **D-04:** Community price data is locale-tagged — German users see aggregate data from German submissions, UK users from UK submissions
+- **D-05:** Price submissions tied to collection ownership — you can only report a price for items you have in your collection (you actually bought it). Captured automatically when adding to collection
+- **D-06:** Candidate items in research threads can also have a "price I found it for" field — research-quality price data during comparison, valuable even before purchase
+- **D-07:** Both "what I paid" and "price I found it for" include a date field (when bought / when found) for temporal context and data aging
+
+### Conversion Strategy
+- **D-08:** Exchange rates sourced from ECB via frankfurter.app — free, daily updates, no API key, covers EUR/USD/GBP/JPY/CAD/AUD and ~30 more
+- **D-09:** Server-side conversion — server fetches rates daily, caches them, returns converted prices in API responses. MCP/API consumers also get conversion
+- **D-10:** Conversion is a FALLBACK, not the default — when a local market price exists, show that. Only convert when no local price is available
+- **D-11:** Converted prices are always clearly labeled as approximate — never presented as real market prices
+
+### User Experience & Display
+- **D-12:** Currency picker = market picker. Selecting EUR implies EU market, GBP implies UK market, USD implies US market. Simplifies settings — one choice drives both currency display and market data filtering
+- **D-13:** Auto-suggestion on first visit based on browser locale and IP geolocation. User can change anytime in settings
+- **D-14:** Converted prices use dual display format: `€2,000 (~£1,720)` — source price prominent, converted in parentheses. Makes it clear what's real vs. approximate
+- **D-15:** Global setting to auto-activate conversion (show converted prices by default) OR per-price toggle. User controls whether they see conversions automatically
+- **D-16:** Existing currency picker in settings page evolves to be the market/currency selector with the auto-suggestion behavior
+
+### Catalog & Sharing Implications
+- **D-17:** Catalog detail page: user's market UVP shown prominently + community average for their market. Collapsible "Other markets" section shows prices from other regions
+- **D-18:** Shared setups (card level): show viewer's market MSRP if available, otherwise converted price
+- **D-19:** Shared setups (detail level): full breakdown — owner's actual price, MSRP per market, community averages, conversion info
+- **D-20:** Comparison tables (thread candidates): normalize all candidates to user's currency for apples-to-apples comparison. Converted prices marked with ~. Users can add their own researched price via "price I found it for"
+- **D-21:** Community price aggregation shows per-market stats: "Users in DE typically pay €1,600 (12 reports)"
+
+### Claude's Discretion
+- Rate caching strategy (how long to cache, fallback when ECB is unreachable)
+- Schema design for market prices table (separate table vs. JSONB on globalItems)
+- Aggregation queries for community price stats (median vs. average, minimum report count threshold)
+- How to handle the transition from the current simple `priceCents` integer to the richer model
+
+</decisions>
+
+<canonical_refs>
+## Canonical References
+
+**Downstream agents MUST read these before planning or implementing.**
+
+No external specs — requirements fully captured in decisions above.
+
+### Existing Implementation (to be replaced/extended)
+- `src/client/lib/formatters.ts` — Current `formatPrice()` with symbol-only swap, `Currency` type (lines 24-45)
+- `src/client/hooks/useCurrency.ts` — Current `useCurrency()` hook reading from settings (6 currencies)
+- `src/client/hooks/useFormatters.ts` — `useFormatters()` hook composing weight + price formatters
+- `src/client/routes/settings.tsx` — Currency pill picker UI (lines 254-280)
+- `src/db/schema.ts` — `priceCents: integer` on items, candidates, globalItems
+- `src/shared/schemas.ts` — Zod schemas with `priceCents` fields
+- `src/server/services/setup.service.ts` — Setup totals computed via SQL SUM on price_cents
+- `src/server/services/discovery.service.ts` — Discovery feed price queries
+- `src/client/components/ComparisonTable.tsx` — Candidate price comparison display
+- `src/client/lib/impactDeltas.ts` — Price delta calculations for setup impact preview
+
+</canonical_refs>
+
+<code_context>
+## Existing Code Insights
+
+### Reusable Assets
+- `useFormatters()` hook: Central price formatting — all price displays go through this. Extend rather than replace
+- `useCurrency()` hook: Already reads currency preference from settings DB — extend to also imply market
+- Settings page currency picker: Existing UI to evolve into market/currency selector
+- `formatPrice()`: Needs to support dual display format and conversion annotations
+
+### Established Patterns
+- Prices stored as integer cents (`priceCents`) throughout the codebase (items, candidates, globalItems, setup aggregates)
+- COALESCE merge for reference items — global base + personal overlay. Currency data needs to work with this pattern
+- SQL aggregates for setup totals — computed on read, not stored. Currency conversion needs to integrate with these queries
+- Settings stored via `useSetting()` hook / settings table — currency/market preference fits this pattern
+
+### Integration Points
+- `src/db/schema.ts`: New market prices table, modify items/candidates for source currency + date fields
+- `src/server/services/`: New currency service for rate fetching, caching, conversion
+- `src/server/services/setup.service.ts`: Setup total queries need currency-aware aggregation
+- `src/server/services/discovery.service.ts`: Feed prices need market-awareness
+- `src/client/lib/formatters.ts`: Dual display format, conversion labeling
+- `src/client/hooks/useCurrency.ts`: Evolve to market-aware hook
+- `src/client/routes/settings.tsx`: Market/currency selector with auto-suggestion
+- `src/server/mcp/`: MCP tools need currency-aware price responses
+- `src/client/components/ComparisonTable.tsx`: Normalized currency display
+- `src/client/routes/global-items/$globalItemId.tsx`: Market prices + community data display
+
+</code_context>
+
+<specifics>
+## Specific Ideas
+
+- The existing currency picker (pill toggle in settings) becomes the market selector — same UI pattern but with market implications
+- Auto-suggestion uses browser locale first, IP geolocation as fallback — suggest on first visit, respect manual override
+- Community price display: "Users in DE typically pay €1,600 (12 reports)" — locale-filtered aggregation
+- Candidate "price I found it for" is research-quality data — valuable even pre-purchase, should be treated as community data too
+- Purchase date on price submissions enables data aging — prices from years ago are less relevant
+- Primary market is EU/DE — start seeding UVP data for European manufacturers
+
+</specifics>
+
+<deferred>
+## Deferred Ideas
+
+None — discussion stayed within phase scope.
+
+</deferred>
+
+---
+
+*Phase: 33-currency-system*
+*Context gathered: 2026-04-13*

.planning/phases/33-currency-system/33-DISCUSSION-LOG.md

@@ -0,0 +1,138 @@
+# Phase 33: Currency System - Discussion Log
+
+> **Audit trail only.** Do not use as input to planning, research, or execution agents.
+> Decisions are captured in CONTEXT.md — this log preserves the alternatives considered.
+
+**Date:** 2026-04-13
+**Phase:** 33-Currency System
+**Areas discussed:** Data model & source currency, Conversion strategy, User experience & display, Catalog & sharing implications
+
+---
+
+## Data Model & Source Currency
+
+### Core pricing model
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Per-item source currency | Add priceCurrency column alongside priceCents | |
+| Per-user base currency only | All prices assumed in user's currency | |
+| Everything stored as USD | Normalize to USD on entry | |
+| Market-specific pricing | Prices are market-specific, not converted. Different markets have different UVP/MSRP | ✓ |
+
+**User's choice:** Market-specific pricing — not just exchange rate conversion. A €2,000 bike in Germany may be £2,200 in the UK because that's the UK market price, not a conversion.
+**Notes:** User emphasized that German UVP (MSRP) can be completely different from UK or US retail prices. This is a market reality, not a conversion problem.
+
+### Community price data
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| On catalog detail page | "Report your price" button | |
+| During add-to-collection | Capture when adding item | |
+| Both (tied to ownership) | Only report for items you own, auto-captured from collection | ✓ |
+
+**User's choice:** Both, but tied to collection ownership — you can only report prices for items you have. Prevents duplicates.
+**Notes:** User also identified that candidate "price I found it for" is research-quality data. Purchase date should be tracked for temporal context.
+
+### Scope check
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Foundation layer | UVP display + conversion, community data later | |
+| Full system | Everything: market prices, community submissions, conversion | ✓ |
+| Let's scope it together | Walk through each piece | |
+
+**User's choice:** Full system in Phase 33.
+
+---
+
+## Conversion Strategy
+
+### Rate source
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Free API (ECB/frankfurter.app) | Daily rates, no API key, ~30 currencies | ✓ |
+| Paid API (Open Exchange Rates) | More currencies, intraday, ~$12/mo | |
+| You decide | Claude picks | |
+
+**User's choice:** Free API — ECB via frankfurter.app
+
+### Conversion location
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Server-side | Server fetches rates, returns converted prices | ✓ |
+| Client-side | Client converts locally | |
+| You decide | Claude picks | |
+
+**User's choice:** Server-side
+
+---
+
+## User Experience & Display
+
+### Market/locale detection
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Manual setting only | User picks market in settings | |
+| Auto-detect + manual override | Browser locale / IP, changeable | |
+| Tied to currency choice | Currency = market, with auto-suggestion | ✓ |
+
+**User's choice:** Currency tied to market (EUR=EU, GBP=UK, USD=US) with auto-suggestion from browser locale and IP geolocation. Best of both worlds.
+
+### Converted price display
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Prefix with ~ and muted style | ~£1,720 with tooltip | |
+| Dual display | €2,000 (~£1,720) — source prominent, converted in parens | ✓ |
+| You decide | Claude picks | |
+
+**User's choice:** Dual display
+
+---
+
+## Catalog & Sharing Implications
+
+### Catalog detail page
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| User's market first, others expandable | Local UVP + community avg prominent, other markets collapsible | ✓ |
+| All markets in a table | Price table showing all markets at once | |
+| You decide | Claude picks | |
+
+**User's choice:** User's market first, others expandable
+
+### Shared setup prices
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Owner's original prices | Show in owner's currency with conversion toggle | |
+| Viewer's market prices | Auto-convert to viewer's currency | |
+| Layered disclosure | Card: viewer's market MSRP. Detail: full breakdown including owner's price | ✓ |
+
+**User's choice:** Layered — card shows viewer's market MSRP, detail page shows full breakdown (owner's price, all market MSRPs, community averages).
+
+### Comparison table currencies
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Normalize to user's currency | All candidates in viewer's currency, marked as approximate | ✓ |
+| Source currency with tooltip | Each in source currency, hover for conversion | |
+| You decide | Claude picks | |
+
+**User's choice:** Normalize — mixed currencies (EUR, USD, JPY, TRY) are useless for comparison. Rough converted price gives direction even if not exact. Users can add their own researched "price I found it for."
+
+## Claude's Discretion
+
+- Rate caching strategy
+- Schema design for market prices table
+- Community price aggregation approach
+- Transition from current simple priceCents model
+
+## Deferred Ideas
+
+None — discussion stayed within phase scope.

.planning/phases/33-currency-system/33-RESEARCH.md

@@ -0,0 +1,261 @@
+# Phase 33: Currency System - Research
+
+**Researched:** 2026-04-13
+**Status:** Complete
+
+## Executive Summary
+
+Phase 33 replaces the current symbol-only currency swap with a market-aware pricing system. The existing codebase stores all prices as integer cents in a single `priceCents` column (items, candidates, globalItems). The current `formatPrice()` simply swaps the currency symbol without conversion. This phase introduces market-specific pricing, exchange rate conversion via frankfurter.app (ECB data), community price data, and a dual-display format for converted prices.
+
+## Current Architecture Analysis
+
+### Price Storage (Single Currency)
+- **items.priceCents** — integer, user's personal item price
+- **items.purchasePriceCents** — integer, what the user paid (already exists, separate from MSRP)
+- **globalItems.priceCents** — integer, catalog reference price (currently no currency/market tag)
+- **threadCandidates.priceCents** — integer, candidate price during research
+- All prices assumed to be in the user's selected currency (symbol swap only)
+
+### Price Display Chain
+1. `useCurrency()` hook reads `currency` setting from DB via `useSetting("currency")`
+2. `useFormatters()` composes `price(cents)` using `formatPrice(cents, currency)`
+3. `formatPrice()` maps currency to symbol and formats cents → display string
+4. All components use `const { price } = useFormatters()` — centralized formatting
+
+### Price Aggregation (SQL)
+- `setup.service.ts`: `SUM(COALESCE(global_items.price_cents, items.price_cents) * items.quantity)` for setup totals
+- `totals.service.ts`: Same COALESCE pattern for category and global totals
+- `discovery.service.ts`: Returns `priceCents` from globalItems without conversion
+- These SQL aggregates assume all prices are in the same currency — they'll need currency-awareness
+
+### Settings Infrastructure
+- `settings` table: key-value pairs per user (`userId`, `key`, `value`)
+- Current `currency` setting: stored as string ("USD", "EUR", etc.)
+- `useSetting()` / `useUpdateSetting()` hooks for read/write
+- Settings page: pill toggle for currency selection (6 options)
+
+## Technical Approach
+
+### 1. Database Schema Design
+
+**New table: `market_prices`** (recommended over JSONB on globalItems)
+
+```sql
+CREATE TABLE market_prices (
+  id SERIAL PRIMARY KEY,
+  global_item_id INTEGER NOT NULL REFERENCES global_items(id) ON DELETE CASCADE,
+  market TEXT NOT NULL,         -- 'EU', 'UK', 'US', etc.
+  currency TEXT NOT NULL,       -- 'EUR', 'GBP', 'USD'
+  price_cents INTEGER NOT NULL, -- MSRP/UVP in that market's currency
+  source TEXT,                  -- 'manufacturer', 'retailer', 'community'
+  created_at TIMESTAMP DEFAULT NOW() NOT NULL,
+  UNIQUE(global_item_id, market, currency)
+);
+```
+
+Rationale: Separate table allows multiple market prices per item without schema changes to globalItems. The existing `globalItems.priceCents` becomes the "default/primary" price (EU market initially).
+
+**New table: `community_prices`**
+
+```sql
+CREATE TABLE community_prices (
+  id SERIAL PRIMARY KEY,
+  global_item_id INTEGER NOT NULL REFERENCES global_items(id) ON DELETE CASCADE,
+  user_id INTEGER NOT NULL REFERENCES users(id),
+  market TEXT NOT NULL,
+  currency TEXT NOT NULL,
+  price_cents INTEGER NOT NULL,
+  price_date TIMESTAMP,         -- when bought/found
+  source_type TEXT NOT NULL,     -- 'purchased' | 'researched'
+  created_at TIMESTAMP DEFAULT NOW() NOT NULL,
+  UNIQUE(global_item_id, user_id, source_type)
+);
+```
+
+**Modify existing tables:**
+- `items`: Add `price_currency TEXT DEFAULT 'EUR'` (source currency for "what I paid")
+- `threadCandidates`: Add `price_currency TEXT DEFAULT 'EUR'`, `found_price_cents INTEGER`, `found_price_currency TEXT`, `found_price_date TIMESTAMP` (D-06, D-07)
+
+### 2. Exchange Rate System
+
+**frankfurter.app API:**
+- Base URL: `https://api.frankfurter.app`
+- Latest rates: `GET /latest?from=EUR&to=USD,GBP`
+- Response: `{ "base": "EUR", "date": "2026-04-13", "rates": { "USD": 1.08, "GBP": 0.86 } }`
+- Free, no API key, daily ECB data, supports 30+ currencies
+- Rate limit: reasonable for daily fetches (no documented limit for <100 req/day)
+
+**New service: `currency.service.ts`**
+
+```typescript
+interface ExchangeRates {
+  base: string;
+  date: string;
+  rates: Record<string, number>;
+}
+
+// Cache in-memory with 24h TTL, fallback to last known rates on fetch failure
+let cachedRates: ExchangeRates | null = null;
+let cacheExpiry: number = 0;
+
+export async function getExchangeRates(): Promise<ExchangeRates> { ... }
+export function convertPrice(cents: number, from: string, to: string, rates: ExchangeRates): number { ... }
+```
+
+**Caching strategy:**
+- In-memory cache with 24h TTL (ECB updates daily ~16:00 CET)
+- On fetch failure: use cached rates (stale but functional)
+- Optional: persist last-known rates to DB settings for cold-start resilience
+- Server-side conversion (D-09) — no client-side rate fetching
+
+### 3. Market Mapping
+
+Currency → Market mapping (D-12):
+```typescript
+const CURRENCY_MARKET_MAP: Record<string, string> = {
+  EUR: 'EU', USD: 'US', GBP: 'UK',
+  JPY: 'JP', CAD: 'CA', AUD: 'AU'
+};
+```
+
+The `currency` setting in the settings table implies market. No separate market setting needed.
+
+### 4. API Changes
+
+**New endpoints:**
+- `GET /api/exchange-rates` — returns current rates (public, cached)
+- `GET /api/global-items/:id/prices` — returns market prices + community data for a catalog item
+
+**Modified endpoints:**
+- All endpoints returning prices should accept optional `?currency=EUR` query param
+- Server converts prices when currency differs from stored currency
+- Converted prices include `{ priceCents, currency, converted: boolean, sourceCurrency?, sourcePrice? }`
+
+**Community price submission:**
+- `POST /api/global-items/:id/prices` — submit "what I paid" (requires auth + item in collection)
+- Candidate "found price" tracked via existing candidate update endpoint with new fields
+
+### 5. Client-Side Changes
+
+**`formatPrice()` evolution:**
+```typescript
+// Current: formatPrice(cents, currency) → "$12.00"
+// New: formatPrice(cents, currency, options?) → "$12.00" or "€12.00 (~$13.00)"
+interface FormatPriceOptions {
+  converted?: boolean;
+  sourceCurrency?: string;
+  sourcePrice?: number;
+  showDual?: boolean;  // dual display format (D-14)
+}
+```
+
+**`useCurrency()` evolution:**
+```typescript
+// Current: returns Currency string
+// New: returns { currency, market, showConversions }
+interface CurrencyContext {
+  currency: Currency;
+  market: string;
+  showConversions: boolean;  // D-15: auto-show conversions toggle
+}
+```
+
+**Settings page:**
+- Currency picker becomes "Market & Currency" selector
+- Auto-suggestion on first visit (D-13): `navigator.language` → locale → suggested currency
+- Toggle for "Show price conversions automatically" (D-15)
+
+### 6. Transition Strategy
+
+The existing `priceCents` on globalItems becomes the EU/default market price. No data migration needed for personal items since they already store "what I paid" in the user's chosen currency. The new `price_currency` column defaults to 'EUR' matching the current assumption.
+
+**Backward compatibility:**
+- All existing `priceCents` fields remain — they're the "primary" price
+- New market_prices table adds additional market prices
+- APIs that currently return `priceCents` continue to do so, with optional conversion
+- `useFormatters()` hook signature stays the same for basic usage
+
+### 7. Community Price Aggregation
+
+Aggregation queries for community stats (D-21):
+- Use median (more robust against outliers than average)
+- Minimum 3 reports before showing aggregate
+- Filter by market for locale-specific stats
+- Include report count for transparency
+
+```sql
+SELECT market, currency,
+  PERCENTILE_CONT(0.5) WITHIN GROUP (ORDER BY price_cents) as median_price,
+  COUNT(*) as report_count
+FROM community_prices
+WHERE global_item_id = $1 AND market = $2
+GROUP BY market, currency
+HAVING COUNT(*) >= 3;
+```
+
+### 8. MCP Tool Updates
+
+Existing MCP tools that return prices need currency context:
+- `list_items`, `get_item`: Include `priceCurrency` in response
+- `create_item`, `update_item`: Accept optional `priceCurrency` param
+- `get_setup`: Include currency info with totals
+- New tool: `get_exchange_rates` — returns current conversion rates
+
+## Risk Assessment
+
+### Low Risk
+- frankfurter.app downtime — mitigated by caching with stale-serve fallback
+- Schema migration — additive only (new tables + new nullable columns)
+- `formatPrice()` changes — backward compatible with optional params
+
+### Medium Risk
+- SQL aggregate complexity — setup/totals queries need to handle mixed currencies when summing prices from items with different source currencies
+- Community price data quality — solved by tying submissions to collection ownership (D-05) and minimum report threshold
+
+### High Risk
+- **Mixed-currency aggregation in setup totals** — when items in a setup have prices in different currencies, SUM is meaningless without conversion. Must convert all to user's currency before aggregating. This adds a server-side conversion step to every setup total query.
+
+## Validation Architecture
+
+### Unit Tests
+- `currency.service.test.ts`: Rate fetching, caching, conversion math
+- `formatPrice()`: Dual display format, conversion labels
+- Market mapping: currency → market resolution
+
+### Integration Tests
+- Market prices CRUD operations
+- Community price submission with ownership validation
+- Setup totals with mixed-currency items
+- Exchange rate caching behavior
+
+### E2E Tests
+- Settings page: market/currency selection
+- Global item detail: market prices display
+- Comparison table: normalized currency display
+- Setup totals: converted price display
+
+## Implementation Order (Recommended Waves)
+
+**Wave 1 — Foundation:**
+1. Schema changes (market_prices, community_prices tables, column additions)
+2. Currency service (rate fetching, caching, conversion)
+3. Database push
+
+**Wave 2 — Server Integration:**
+4. Market prices API endpoints
+5. Price conversion in existing endpoints
+6. Setup/totals query updates for currency-awareness
+
+**Wave 3 — Client & Display:**
+7. Formatter evolution (dual display, conversion labels)
+8. Settings page market/currency selector
+9. Global item detail with market prices
+10. Comparison table currency normalization
+11. MCP tool updates
+
+---
+
+## RESEARCH COMPLETE
+
+*Phase: 33-currency-system*
+*Research completed: 2026-04-13*

.planning/phases/33-currency-system/33-UI-SPEC.md

@@ -0,0 +1,251 @@
+---
+phase: 33
+slug: currency-system
+status: draft
+shadcn_initialized: false
+preset: none
+created: 2026-04-13
+---
+
+# Phase 33 — UI Design Contract
+
+> Visual and interaction contract for the Currency System phase. Covers market/currency selector, dual price display, converted price labels, community price aggregation display, and candidate research price fields.
+
+---
+
+## Design System
+
+| Property | Value |
+|----------|-------|
+| Tool | none |
+| Preset | not applicable |
+| Component library | none (custom Tailwind components) |
+| Icon library | Lucide via `LucideIcon` from `lib/iconData` |
+| Font | System font stack (Tailwind default) |
+
+---
+
+## Spacing Scale
+
+Declared values (must be multiples of 4):
+
+| Token | Value | Usage |
+|-------|-------|-------|
+| xs | 4px | Icon gaps, inline padding |
+| sm | 8px | Compact element spacing, pill toggle gaps |
+| md | 16px | Default element spacing, card padding |
+| lg | 24px | Section padding within cards |
+| xl | 32px | Layout gaps between sections |
+| 2xl | 48px | Major section breaks |
+| 3xl | 64px | Page-level spacing |
+
+Exceptions: none
+
+---
+
+## Typography
+
+| Role | Size | Weight | Line Height |
+|------|------|--------|-------------|
+| Body | 14px (text-sm) | 400 (normal) | 1.5 |
+| Label | 12px (text-xs) | 500 (medium) | 1.5 |
+| Heading | 20px (text-xl) | 600 (semibold) | 1.4 |
+| Display | 14px (text-sm) | 600 (semibold) | 1.5 |
+
+Matches existing app typography (settings page, detail pages).
+
+---
+
+## Color
+
+| Role | Value | Usage |
+|------|-------|-------|
+| Dominant (60%) | #ffffff | Page background, card surfaces |
+| Secondary (30%) | #f9fafb / #f3f4f6 | Gray-50/100 — pill backgrounds, inactive states, card borders |
+| Accent (10%) | #3b82f6 | Blue-500 — conversion indicator icon, "best price" highlight |
+| Destructive | #ef4444 | Red-500 — not used in this phase |
+
+Accent reserved for: conversion indicator dots, "best price" cell highlight (green-50 for price, blue-50 for weight — existing pattern from ComparisonTable)
+
+### Phase-Specific Colors
+
+| Element | Color | Tailwind Class |
+|---------|-------|----------------|
+| Converted price text | gray-400 | `text-gray-400` |
+| Conversion tilde prefix | gray-400 | `text-gray-400` |
+| Market price label | gray-500 | `text-gray-500` |
+| Community price aggregate | gray-700 | `text-gray-700` |
+| Community report count | gray-400 | `text-gray-400` |
+| Auto-suggestion banner background | blue-50 | `bg-blue-50` |
+| Auto-suggestion banner text | blue-700 | `text-blue-700` |
+
+---
+
+## Component Specifications
+
+### 1. Market/Currency Selector (Settings Page)
+
+Evolves the existing currency pill toggle. Same visual pattern, updated copy.
+
+**Layout:**
+```
+┌──────────────────────────────────────────────────────────┐
+│ Market & Currency                                         │
+│ Sets your market region and currency for price display    │
+│                                                          │
+│ ┌────────────────────────────────────────────────┐       │
+│ │ [$ USD] [€ EUR] [£ GBP] [¥ JPY] [CA$ CAD] [A$ AUD] │ │
+│ └────────────────────────────────────────────────┘       │
+│                                                          │
+│ ── separator ──                                          │
+│                                                          │
+│ Show Converted Prices                            [toggle]│
+│ Display approximate conversions when local price          │
+│ is not available                                          │
+└──────────────────────────────────────────────────────────┘
+```
+
+**Specs:**
+- Pill toggle: same `bg-gray-100 rounded-full` container, same button styles as existing
+- Selected pill: `bg-white text-gray-700 shadow-sm font-medium`
+- Unselected pill: `text-gray-400 hover:text-gray-600`
+- New toggle for "Show Converted Prices": standard toggle switch, `bg-gray-200` off / `bg-blue-500` on
+- Section heading: `text-sm font-medium text-gray-900`
+- Description: `text-xs text-gray-500 mt-0.5`
+
+### 2. Auto-Suggestion Banner (First Visit)
+
+Shown once when no currency preference is set. Appears above the settings card.
+
+**Layout:**
+```
+┌──────────────────────────────────────────────────────────┐
+│ 🌍  Based on your location, we suggest EUR (€)  [Use €] │
+└──────────────────────────────────────────────────────────┘
+```
+
+**Specs:**
+- Container: `bg-blue-50 border border-blue-100 rounded-xl px-4 py-3`
+- Text: `text-sm text-blue-700`
+- Button: `text-sm font-medium text-blue-700 hover:text-blue-800 underline`
+- Globe icon: Lucide `globe` icon, 16px, `text-blue-500`
+- Dismissible: clicking "Use €" sets the setting and hides the banner
+
+### 3. Dual Price Display Format (D-14)
+
+When a price is converted from another currency, display both.
+
+**Inline format:** `€2,000 (~$2,160)`
+
+**Specs:**
+- Source price: `text-sm font-medium text-gray-900` (existing style)
+- Converted price: `text-xs text-gray-400 ml-1`
+- Tilde prefix: included in converted text as literal `~`
+- No line break between source and converted — inline on same line
+- If no conversion needed (local price exists): show only the local price, no parenthetical
+
+### 4. Global Item Detail — Market Prices Section (D-17)
+
+New section on the catalog item detail page, below existing specs.
+
+**Layout:**
+```
+┌──────────────────────────────────────────────────────────┐
+│ Price                                                     │
+│                                                          │
+│ €2,199.00  MSRP (EU)                                    │
+│                                                          │
+│ Community (DE): €1,680 median (14 reports)               │
+│                                                          │
+│ ▸ Other Markets                                          │
+│   $2,499.00  MSRP (US)                                  │
+│   £1,999.00  MSRP (UK)                                  │
+│   Community (US): $2,100 median (8 reports)              │
+└──────────────────────────────────────────────────────────┘
+```
+
+**Specs:**
+- Section heading: `text-sm font-medium text-gray-900`
+- Primary market price: `text-lg font-semibold text-gray-900`
+- Market label: `text-xs text-gray-500 ml-2`
+- Community line: `text-sm text-gray-700`
+- Report count: `text-xs text-gray-400` in parentheses
+- "Other Markets" collapsible: `text-sm text-gray-500 cursor-pointer hover:text-gray-700`
+- Chevron: Lucide `chevron-right` (rotates to `chevron-down` when expanded), 14px
+- Collapsed by default
+- Inner market rows: same styling, indented with `pl-4`
+
+### 5. Comparison Table — Currency Normalization (D-20)
+
+Extends existing ComparisonTable component.
+
+**Existing behavior preserved.** Additional specs:
+- When candidate price is in a different currency than user's preference, show dual format in the price cell
+- Converted prices show `~` prefix: `~$2,160` in `text-gray-400`
+- Best-price highlighting (existing `bg-green-50`) still applies after conversion
+- New "Found Price" row in comparison table for candidate research prices (D-06)
+
+### 6. Candidate "Price I Found" Field (D-06, D-07)
+
+New fields in the candidate edit form.
+
+**Layout:**
+```
+┌──────────────────────────────────────────────────────────┐
+│ Price I Found                                             │
+│ ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐│
+│ │ $ _____.__ │  │ USD ▾      │  │ 2026-04-13     ││
+│ └──────────────┘  └──────────────┘  └──────────────────┘│
+│ Research price — when you found it at this price          │
+└──────────────────────────────────────────────────────────┘
+```
+
+**Specs:**
+- Field row: three inputs inline (`flex gap-2`)
+- Price input: standard number input matching existing `priceCents` field style
+- Currency select: small dropdown matching existing form select style, `text-xs`
+- Date input: standard date input, `text-xs`
+- Helper text: `text-xs text-gray-400 mt-1`
+
+---
+
+## Copywriting Contract
+
+| Element | Copy |
+|---------|------|
+| Market selector heading | "Market & Currency" |
+| Market selector description | "Sets your market region and currency for price display" |
+| Conversion toggle heading | "Show Converted Prices" |
+| Conversion toggle description | "Display approximate conversions when local price is not available" |
+| Auto-suggestion text | "Based on your location, we suggest {CURRENCY} ({SYMBOL})" |
+| Auto-suggestion CTA | "Use {SYMBOL}" |
+| Converted price label | "~{SYMBOL}{amount}" (inline, no separate label) |
+| Community price line | "Community ({MARKET}): {SYMBOL}{median} median ({N} reports)" |
+| Other markets toggle | "Other Markets" |
+| Found price label | "Price I Found" |
+| Found price helper | "Research price — when you found it at this price" |
+| No market price fallback | "No local price — showing converted estimate" |
+| Price section heading | "Price" |
+
+---
+
+## Registry Safety
+
+| Registry | Blocks Used | Safety Gate |
+|----------|-------------|-------------|
+| No registries | N/A | N/A |
+
+This phase uses only custom Tailwind components matching existing codebase patterns.
+
+---
+
+## Checker Sign-Off
+
+- [ ] Dimension 1 Copywriting: PASS
+- [ ] Dimension 2 Visuals: PASS
+- [ ] Dimension 3 Color: PASS
+- [ ] Dimension 4 Typography: PASS
+- [ ] Dimension 5 Spacing: PASS
+- [ ] Dimension 6 Registry Safety: PASS
+
+**Approval:** pending

.planning/phases/33-currency-system/33-VALIDATION.md

@@ -0,0 +1,82 @@
+---
+phase: 33
+slug: currency-system
+status: draft
+nyquist_compliant: false
+wave_0_complete: false
+created: 2026-04-13
+---
+
+# Phase 33 — Validation Strategy
+
+> Per-phase validation contract for feedback sampling during execution.
+
+---
+
+## Test Infrastructure
+
+| Property | Value |
+|----------|-------|
+| **Framework** | Bun test runner + Playwright |
+| **Config file** | `bunfig.toml` / `playwright.config.ts` |
+| **Quick run command** | `bun test` |
+| **Full suite command** | `bun test && bun run test:e2e` |
+| **Estimated runtime** | ~15 seconds (unit) + ~60 seconds (e2e) |
+
+---
+
+## Sampling Rate
+
+- **After every task commit:** Run `bun test`
+- **After every plan wave:** Run `bun test && bun run test:e2e`
+- **Before `/gsd-verify-work`:** Full suite must be green
+- **Max feedback latency:** 15 seconds
+
+---
+
+## Per-Task Verification Map
+
+| Task ID | Plan | Wave | Requirement | Threat Ref | Secure Behavior | Test Type | Automated Command | File Exists | Status |
+|---------|------|------|-------------|------------|-----------------|-----------|-------------------|-------------|--------|
+| 33-01-01 | 01 | 1 | D-01, D-02 | — | N/A | unit | `bun test tests/services/currency.service.test.ts` | ❌ W0 | ⬜ pending |
+| 33-01-02 | 01 | 1 | D-08, D-09 | — | N/A | unit | `bun test tests/services/currency.service.test.ts` | ❌ W0 | ⬜ pending |
+| 33-02-01 | 02 | 2 | D-01 | — | N/A | integration | `bun test tests/services/market-price.service.test.ts` | ❌ W0 | ⬜ pending |
+| 33-02-02 | 02 | 2 | D-04, D-05 | — | Ownership validation | integration | `bun test tests/services/community-price.service.test.ts` | ❌ W0 | ⬜ pending |
+| 33-03-01 | 03 | 3 | D-12, D-14 | — | N/A | unit | `bun test tests/lib/formatters.test.ts` | ❌ W0 | ⬜ pending |
+| 33-03-02 | 03 | 3 | D-16 | — | N/A | e2e | `bun run test:e2e --grep "currency"` | ❌ W0 | ⬜ pending |
+
+*Status: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky*
+
+---
+
+## Wave 0 Requirements
+
+- [ ] `tests/services/currency.service.test.ts` — stubs for rate fetching, caching, conversion
+- [ ] `tests/services/market-price.service.test.ts` — stubs for market price CRUD
+- [ ] `tests/services/community-price.service.test.ts` — stubs for community price submission + ownership validation
+- [ ] `tests/lib/formatters.test.ts` — stubs for dual display format, conversion labels
+
+*Existing test infrastructure (Bun test runner, createTestDb helper) covers framework needs.*
+
+---
+
+## Manual-Only Verifications
+
+| Behavior | Requirement | Why Manual | Test Instructions |
+|----------|-------------|------------|-------------------|
+| Auto-suggestion via browser locale | D-13 | Requires browser environment with locale | Open app in incognito, verify suggestion matches browser locale |
+| Dual display format readability | D-14 | Visual check | Verify converted prices show `€2,000 (~$2,160)` format |
+| Community price aggregation display | D-21 | Requires seeded community data | Seed 3+ price reports, verify "Users in DE typically pay..." display |
+
+---
+
+## Validation Sign-Off
+
+- [ ] All tasks have `<automated>` verify or Wave 0 dependencies
+- [ ] Sampling continuity: no 3 consecutive tasks without automated verify
+- [ ] Wave 0 covers all MISSING references
+- [ ] No watch-mode flags
+- [ ] Feedback latency < 15s
+- [ ] `nyquist_compliant: true` set in frontmatter
+
+**Approval:** pending

.planning/phases/34-i18n-foundation/34-01-PLAN.md

@@ -0,0 +1,319 @@
+---
+phase: 34-i18n-foundation
+plan: 01
+type: execute
+wave: 1
+depends_on: []
+files_modified:
+  - package.json
+  - src/client/lib/i18n.ts
+  - src/client/main.tsx
+  - src/client/locales/en/common.json
+  - src/client/locales/en/collection.json
+  - src/client/locales/en/threads.json
+  - src/client/locales/en/setups.json
+  - src/client/locales/en/onboarding.json
+  - src/client/locales/en/settings.json
+autonomous: true
+requirements: [D-05, D-06, D-07, D-08, D-12]
+
+must_haves:
+  truths:
+    - "i18next, react-i18next, and i18next-browser-languagedetector are installed"
+    - "i18n.ts initializes i18next with LanguageDetector and initReactI18next"
+    - "English locale JSON files exist in src/client/locales/en/ with namespaces: common, collection, threads, setups, onboarding, settings"
+    - "main.tsx imports i18n.ts before rendering the app"
+    - "fallback language is set to en"
+    - "Language detection order is localStorage then navigator"
+  artifacts:
+    - path: "src/client/lib/i18n.ts"
+      provides: "i18next initialization with language detection and all namespaces"
+      contains: "initReactI18next"
+    - path: "src/client/locales/en/common.json"
+      provides: "English common namespace translations"
+      contains: "save"
+    - path: "package.json"
+      provides: "i18n dependencies"
+      contains: "react-i18next"
+  key_links:
+    - from: "src/client/main.tsx"
+      to: "src/client/lib/i18n.ts"
+      via: "import statement"
+      pattern: "import.*i18n"
+---
+
+<objective>
+Install the i18n framework (react-i18next) and create all English locale JSON files with namespace structure.
+
+Purpose: Foundation — all other plans depend on having i18next initialized and English strings extracted into JSON files.
+Output: Working i18n setup with all English translation files, app initializes i18next before rendering.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/34-i18n-foundation/34-CONTEXT.md
+@.planning/phases/34-i18n-foundation/34-RESEARCH.md
+
+<interfaces>
+From src/client/main.tsx:
+```typescript
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { createRouter, RouterProvider } from "@tanstack/react-router";
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { routeTree } from "./routeTree.gen";
+```
+
+From src/client/hooks/useFormatters.ts:
+```typescript
+export function useFormatters() {
+  const unit = useWeightUnit();
+  const currency = useCurrency();
+  return {
+    weight: (grams: number | null) => formatWeight(grams, unit),
+    price: (cents: number | null) => formatPrice(cents, currency),
+    unit,
+    currency,
+  };
+}
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Install i18n packages</name>
+  <files>package.json</files>
+  <read_first>package.json</read_first>
+  <behavior>
+    - i18next is in dependencies
+    - react-i18next is in dependencies
+    - i18next-browser-languagedetector is in dependencies
+  </behavior>
+  <action>
+Run: `bun add i18next react-i18next i18next-browser-languagedetector`
+
+This adds the three required packages:
+- `i18next` — core translation engine (~8KB)
+- `react-i18next` — React hooks and components (`useTranslation`)
+- `i18next-browser-languagedetector` — auto-detect browser locale from `navigator.language` (D-10)
+  </action>
+  <acceptance_criteria>
+    - package.json contains "i18next" in dependencies
+    - package.json contains "react-i18next" in dependencies
+    - package.json contains "i18next-browser-languagedetector" in dependencies
+    - `bun install` completes without errors
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && grep -c "i18next\|react-i18next\|i18next-browser-languagedetector" package.json</automated>
+  </verify>
+  <done>All three i18n packages installed</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Create English locale JSON files with all translatable strings</name>
+  <files>src/client/locales/en/common.json, src/client/locales/en/collection.json, src/client/locales/en/threads.json, src/client/locales/en/setups.json, src/client/locales/en/onboarding.json, src/client/locales/en/settings.json</files>
+  <read_first>src/client/components/TopNav.tsx, src/client/components/BottomTabBar.tsx, src/client/components/FabMenu.tsx, src/client/components/ConfirmDialog.tsx, src/client/components/AuthPromptModal.tsx, src/client/routes/__root.tsx, src/client/components/CollectionView.tsx, src/client/components/ItemCard.tsx, src/client/components/ItemForm.tsx, src/client/components/CategoryPicker.tsx, src/client/components/CategoryHeader.tsx, src/client/components/WeightSummaryCard.tsx, src/client/components/PlanningView.tsx, src/client/components/ThreadCard.tsx, src/client/components/ThreadTabs.tsx, src/client/components/CandidateCard.tsx, src/client/components/CandidateForm.tsx, src/client/components/ComparisonTable.tsx, src/client/components/CreateThreadModal.tsx, src/client/components/SetupsView.tsx, src/client/components/SetupCard.tsx, src/client/components/SetupImpactSelector.tsx, src/client/components/ShareModal.tsx, src/client/components/onboarding/OnboardingWelcome.tsx, src/client/components/onboarding/OnboardingHobbyPicker.tsx, src/client/components/onboarding/OnboardingItemBrowser.tsx, src/client/components/onboarding/OnboardingReview.tsx, src/client/components/onboarding/OnboardingDone.tsx, src/client/components/onboarding/OnboardingFlow.tsx, src/client/routes/settings.tsx, src/client/components/StatusBadge.tsx, src/client/components/ClassificationBadge.tsx, src/client/components/ExternalLinkDialog.tsx, src/client/components/CatalogSearchOverlay.tsx, src/client/components/AddToCollectionModal.tsx, src/client/components/AddToThreadModal.tsx, src/client/components/GlobalItemCard.tsx, src/client/components/GearImage.tsx, src/client/components/ImageUpload.tsx, src/client/components/DashboardCard.tsx, src/client/components/TotalsBar.tsx, src/client/components/ImpactDeltaBadge.tsx, src/client/routes/index.tsx, src/client/routes/login.tsx, src/client/routes/profile.tsx, src/client/components/UserMenu.tsx, src/client/components/ProfileSection.tsx, src/client/components/PublicSetupCard.tsx, src/client/components/ManualEntryForm.tsx, src/client/components/LinkToGlobalItem.tsx, src/client/components/SlideOutPanel.tsx, src/client/components/ItemPicker.tsx, src/client/components/ImageCropEditor.tsx, src/client/components/CategoryFilterDropdown.tsx</read_first>
+  <behavior>
+    - src/client/locales/en/common.json contains keys for: nav items, action buttons (save, cancel, delete, edit, create, back, close, search, confirm), empty states, error messages, loading states, auth prompts
+    - src/client/locales/en/collection.json contains keys for: collection page, item cards, item forms, category picker, weight summary, planning view, totals bar
+    - src/client/locales/en/threads.json contains keys for: thread list, thread detail, candidate cards, candidate form, comparison table, create thread modal, status badges
+    - src/client/locales/en/setups.json contains keys for: setup list, setup detail, setup cards, impact preview, share modal
+    - src/client/locales/en/onboarding.json contains keys for: welcome, hobby picker, item browser, review, done screens
+    - src/client/locales/en/settings.json contains keys for: settings page, weight unit, currency, API keys, import/export
+  </behavior>
+  <action>
+Create directory `src/client/locales/en/`.
+
+Read EVERY component listed in read_first. For each component, extract all hardcoded English strings (button text, headings, labels, descriptions, placeholder text, error messages, empty states, toast messages, modal titles/descriptions, confirmation dialogs) and add them to the appropriate namespace JSON file.
+
+**String key convention:** Nested objects with dot notation access. Group by component/feature. Use camelCase for keys.
+
+Example structure for `common.json`:
+```json
+{
+  "nav": {
+    "home": "Home",
+    "collection": "Collection",
+    "setups": "Setups",
+    "discover": "Discover",
+    "settings": "Settings",
+    "search": "Search"
+  },
+  "actions": {
+    "save": "Save",
+    "cancel": "Cancel",
+    "delete": "Delete",
+    "edit": "Edit",
+    "create": "Create",
+    "close": "Close",
+    "back": "Back",
+    "confirm": "Confirm",
+    "tryAgain": "Try again",
+    "dismiss": "Dismiss",
+    "loading": "Loading...",
+    "saving": "Saving...",
+    "deleting": "Deleting..."
+  },
+  "errors": {
+    "somethingWentWrong": "Something went wrong",
+    "unexpectedError": "An unexpected error occurred"
+  },
+  "auth": {
+    "signIn": "Sign in",
+    "signInRequired": "Sign in to continue",
+    "signInDescription": "Create an account or sign in to start tracking your gear"
+  }
+}
+```
+
+**IMPORTANT:** Read every component file thoroughly. Do NOT guess strings — extract the actual English text from the JSX. Every user-visible string in the component should become a translation key.
+
+For interpolation (dynamic values), use `{{variable}}` syntax. Example: if a component shows "3 items", the key would be `"itemCount": "{{count}} items"` or use pluralization `"itemCount_one": "{{count}} item"`, `"itemCount_other": "{{count}} items"`.
+
+Do NOT translate: item names, category names created by users, thread titles, candidate names, setup names — these are user-generated content (D-03).
+  </action>
+  <acceptance_criteria>
+    - src/client/locales/en/common.json exists and is valid JSON
+    - src/client/locales/en/collection.json exists and is valid JSON
+    - src/client/locales/en/threads.json exists and is valid JSON
+    - src/client/locales/en/setups.json exists and is valid JSON
+    - src/client/locales/en/onboarding.json exists and is valid JSON
+    - src/client/locales/en/settings.json exists and is valid JSON
+    - common.json contains "nav" key with at least "home", "collection", "setups"
+    - common.json contains "actions" key with at least "save", "cancel", "delete"
+    - settings.json contains keys for "weightUnit", "currency", "apiKeys", "importExport"
+    - onboarding.json contains keys for all 5 onboarding steps (welcome, hobby, items, review, done)
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && for f in common collection threads setups onboarding settings; do node -e "JSON.parse(require('fs').readFileSync('src/client/locales/en/$f.json','utf8')); console.log('$f.json: valid')"; done</automated>
+  </verify>
+  <done>All 6 English namespace JSON files created with strings extracted from every component</done>
+</task>
+
+<task type="auto">
+  <name>Task 3: Create i18n initialization module and wire into app entry point</name>
+  <files>src/client/lib/i18n.ts, src/client/main.tsx</files>
+  <read_first>src/client/main.tsx, src/client/locales/en/common.json</read_first>
+  <behavior>
+    - src/client/lib/i18n.ts initializes i18next with LanguageDetector and initReactI18next
+    - Resources include all 6 namespaces for "en" locale
+    - fallbackLng is "en"
+    - defaultNS is "common"
+    - interpolation.escapeValue is false (React handles XSS)
+    - Detection order is ["localStorage", "navigator"]
+    - Detection lookupLocalStorage is "gearbox-language"
+    - Detection caches is ["localStorage"]
+    - main.tsx imports i18n.ts before any React rendering (side-effect import)
+  </behavior>
+  <action>
+Create `src/client/lib/i18n.ts`:
+
+```typescript
+import i18n from "i18next";
+import LanguageDetector from "i18next-browser-languagedetector";
+import { initReactI18next } from "react-i18next";
+
+import enCommon from "../locales/en/common.json";
+import enCollection from "../locales/en/collection.json";
+import enThreads from "../locales/en/threads.json";
+import enSetups from "../locales/en/setups.json";
+import enOnboarding from "../locales/en/onboarding.json";
+import enSettings from "../locales/en/settings.json";
+
+i18n
+  .use(LanguageDetector)
+  .use(initReactI18next)
+  .init({
+    resources: {
+      en: {
+        common: enCommon,
+        collection: enCollection,
+        threads: enThreads,
+        setups: enSetups,
+        onboarding: enOnboarding,
+        settings: enSettings,
+      },
+    },
+    fallbackLng: "en",
+    defaultNS: "common",
+    interpolation: {
+      escapeValue: false,
+    },
+    detection: {
+      order: ["localStorage", "navigator"],
+      lookupLocalStorage: "gearbox-language",
+      caches: ["localStorage"],
+    },
+  });
+
+export default i18n;
+```
+
+Update `src/client/main.tsx` — add `import "./lib/i18n";` as the FIRST import (before React, before QueryClient, before Router). This ensures i18next is initialized before any component tries to use `useTranslation()`. The import is a side-effect import — no named export needed.
+
+The final import order in main.tsx should be:
+1. `import "./lib/i18n";` (side-effect — initializes i18next)
+2. Existing imports (QueryClient, Router, etc.)
+  </action>
+  <acceptance_criteria>
+    - src/client/lib/i18n.ts exists
+    - src/client/lib/i18n.ts contains `import { initReactI18next } from "react-i18next"`
+    - src/client/lib/i18n.ts contains `fallbackLng: "en"`
+    - src/client/lib/i18n.ts contains `defaultNS: "common"`
+    - src/client/lib/i18n.ts contains `lookupLocalStorage: "gearbox-language"`
+    - src/client/lib/i18n.ts imports all 6 en namespace JSON files
+    - src/client/main.tsx first import line is `import "./lib/i18n"`
+    - `bun run build` completes without errors
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && grep -c "initReactI18next\|fallbackLng\|defaultNS\|LanguageDetector" src/client/lib/i18n.ts && head -3 src/client/main.tsx | grep -c "i18n"</automated>
+  </verify>
+  <done>i18n initialized with language detection, all English namespaces loaded, app entry point imports i18n first</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| localStorage→i18n | Language preference read from localStorage — treated as user preference, not security-sensitive |
+| navigator.language→i18n | Browser locale — untrusted but benign (only matched against known locales) |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-34-01 | Tampering | i18n.ts localStorage | accept | Language preference is non-sensitive. Tampered localStorage key only affects UI language, not data. Validated against known locale list via i18next supportedLngs. |
+| T-34-02 | Information Disclosure | locale JSON files | accept | Translation files contain only UI strings, no secrets. Bundled in client JS — intentionally public. |
+</threat_model>
+
+<verification>
+- `bun install` completes without errors
+- All 6 en/*.json files are valid JSON
+- `bun run build` completes without errors
+- src/client/lib/i18n.ts initializes correctly with all namespaces
+- src/client/main.tsx imports i18n before rendering
+</verification>
+
+<success_criteria>
+- i18next and react-i18next installed
+- All English translation strings extracted into 6 namespace JSON files
+- i18n initialization module created with language detection
+- App entry point wires i18n before React rendering
+- Build passes
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/34-i18n-foundation/34-01-SUMMARY.md`
+</output>

.planning/phases/34-i18n-foundation/34-02-PLAN.md

@@ -0,0 +1,447 @@
+---
+phase: 34-i18n-foundation
+plan: 02
+type: execute
+wave: 1
+depends_on: [01]
+files_modified:
+  - src/client/components/TopNav.tsx
+  - src/client/components/BottomTabBar.tsx
+  - src/client/components/FabMenu.tsx
+  - src/client/components/ConfirmDialog.tsx
+  - src/client/components/AuthPromptModal.tsx
+  - src/client/components/ExternalLinkDialog.tsx
+  - src/client/components/CatalogSearchOverlay.tsx
+  - src/client/components/AddToCollectionModal.tsx
+  - src/client/components/AddToThreadModal.tsx
+  - src/client/components/UserMenu.tsx
+  - src/client/components/CollectionView.tsx
+  - src/client/components/ItemCard.tsx
+  - src/client/components/ItemForm.tsx
+  - src/client/components/CategoryPicker.tsx
+  - src/client/components/CategoryHeader.tsx
+  - src/client/components/WeightSummaryCard.tsx
+  - src/client/components/PlanningView.tsx
+  - src/client/components/TotalsBar.tsx
+  - src/client/components/DashboardCard.tsx
+  - src/client/components/ThreadCard.tsx
+  - src/client/components/ThreadTabs.tsx
+  - src/client/components/CandidateCard.tsx
+  - src/client/components/CandidateForm.tsx
+  - src/client/components/CandidateListItem.tsx
+  - src/client/components/ComparisonTable.tsx
+  - src/client/components/CreateThreadModal.tsx
+  - src/client/components/StatusBadge.tsx
+  - src/client/components/ClassificationBadge.tsx
+  - src/client/components/SetupsView.tsx
+  - src/client/components/SetupCard.tsx
+  - src/client/components/SetupImpactSelector.tsx
+  - src/client/components/ShareModal.tsx
+  - src/client/components/ImpactDeltaBadge.tsx
+  - src/client/components/ItemPicker.tsx
+  - src/client/components/ImageUpload.tsx
+  - src/client/components/GearImage.tsx
+  - src/client/components/GlobalItemCard.tsx
+  - src/client/components/ManualEntryForm.tsx
+  - src/client/components/LinkToGlobalItem.tsx
+  - src/client/components/ProfileSection.tsx
+  - src/client/components/PublicSetupCard.tsx
+  - src/client/routes/__root.tsx
+  - src/client/routes/index.tsx
+  - src/client/routes/login.tsx
+  - src/client/routes/profile.tsx
+  - src/client/routes/settings.tsx
+  - src/client/routes/collection/index.tsx
+  - src/client/routes/collection/gear.tsx
+  - src/client/routes/items/$itemId.tsx
+  - src/client/routes/threads/index.tsx
+  - src/client/routes/threads/$threadId.tsx
+  - src/client/routes/setups/$setupId.tsx
+  - src/client/routes/global-items/index.tsx
+  - src/client/routes/global-items/$itemId.tsx
+  - src/client/routes/users/$userId.tsx
+autonomous: true
+requirements: [D-01, D-02, D-03]
+
+must_haves:
+  truths:
+    - "Every component with hardcoded English strings uses useTranslation() hook"
+    - "t() function calls reference keys that exist in the English locale JSON files from Plan 01"
+    - "User-generated content (item names, category names, thread titles, setup names) is NOT wrapped in t()"
+    - "All components import useTranslation from react-i18next"
+    - "No hardcoded English strings remain in UI chrome elements (buttons, labels, headings, nav items, empty states, error messages, toasts)"
+  artifacts:
+    - path: "src/client/components/TopNav.tsx"
+      provides: "Translated navigation"
+      contains: "useTranslation"
+    - path: "src/client/components/BottomTabBar.tsx"
+      provides: "Translated tab labels"
+      contains: "useTranslation"
+    - path: "src/client/routes/settings.tsx"
+      provides: "Translated settings page"
+      contains: "useTranslation"
+  key_links:
+    - from: "src/client/components/TopNav.tsx"
+      to: "src/client/locales/en/common.json"
+      via: "useTranslation('common')"
+      pattern: "t\\("
+---
+
+<objective>
+Replace all hardcoded English strings in UI components with i18n t() calls.
+
+Purpose: Complete string extraction — after this plan, all UI chrome text comes from translation files instead of hardcoded strings.
+Output: Every component uses useTranslation() hook, all strings reference keys from en/*.json.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/34-i18n-foundation/34-CONTEXT.md
+@.planning/phases/34-i18n-foundation/34-RESEARCH.md
+
+<interfaces>
+useTranslation hook pattern:
+```typescript
+import { useTranslation } from "react-i18next";
+
+function MyComponent() {
+  const { t } = useTranslation("common"); // or specific namespace
+  return <button>{t("actions.save")}</button>;
+}
+```
+
+For multiple namespaces in one component:
+```typescript
+const { t } = useTranslation(["common", "collection"]);
+// Access: t("common:actions.save"), t("collection:itemCard.title")
+// Or with default namespace: t("actions.save") uses first in array
+```
+
+For interpolation:
+```typescript
+t("items.count", { count: 5 }) // "5 items"
+t("items.count_one", { count: 1 }) // "1 item" (plural)
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Extract strings from navigation and global UI components</name>
+  <files>src/client/components/TopNav.tsx, src/client/components/BottomTabBar.tsx, src/client/components/FabMenu.tsx, src/client/components/UserMenu.tsx, src/client/routes/__root.tsx</files>
+  <read_first>src/client/components/TopNav.tsx, src/client/components/BottomTabBar.tsx, src/client/components/FabMenu.tsx, src/client/components/UserMenu.tsx, src/client/routes/__root.tsx, src/client/locales/en/common.json</read_first>
+  <behavior>
+    - TopNav.tsx uses t() for "Collection", "Setups", "Discover" nav labels and search placeholder
+    - BottomTabBar.tsx uses t() for "Home", "Collection", "Search", "Setups" tab labels
+    - FabMenu.tsx uses t() for all menu item labels
+    - UserMenu.tsx uses t() for menu items like "Settings", "Sign out", profile-related labels
+    - __root.tsx uses t() for "Something went wrong", "Try again", "Delete Candidate", "Pick Winner" dialog text
+    - All components import { useTranslation } from "react-i18next"
+  </behavior>
+  <action>
+For each component listed in files, add `import { useTranslation } from "react-i18next"` and destructure `const { t } = useTranslation("common")` at the top of the component function body (or use the appropriate namespace).
+
+**TopNav.tsx:**
+- Replace "Collection" with `t("nav.collection")`
+- Replace "Setups" with `t("nav.setups")`
+- Replace "Discover" with `t("nav.discover")`
+- Replace search input placeholder with `t("nav.searchPlaceholder")`
+- Replace "GearBox" brand text — leave as-is (brand name, not translatable)
+
+**BottomTabBar.tsx:**
+- Replace "Home" with `t("nav.home")`
+- Replace "Collection" with `t("nav.collection")`
+- Replace "Search" with `t("nav.search")`
+- Replace "Setups" with `t("nav.setups")`
+
+**FabMenu.tsx:**
+- Replace all menu item labels with `t("fab.addItem")`, `t("fab.newThread")`, `t("fab.newSetup")` etc. (read the component to find exact labels)
+
+**UserMenu.tsx:**
+- Replace "Settings" with `t("nav.settings")`
+- Replace "Sign out" / "Log out" with `t("auth.signOut")`
+- Replace other menu text with appropriate t() keys
+
+**__root.tsx:**
+- Replace "Something went wrong" with `t("errors.somethingWentWrong")`
+- Replace "Try again" with `t("actions.tryAgain")`
+- Replace "Delete Candidate" dialog title/text with `t("common:actions.deleteCandidate")` etc.
+- Replace "Pick Winner" dialog with `t("threads:resolve.title")` etc.
+- Replace "Cancel" buttons with `t("actions.cancel")`
+- Replace "Delete" buttons with `t("actions.delete")`
+
+**IMPORTANT:** Do NOT wrap user-generated content (candidateName, thread title, etc.) in t() — only UI chrome.
+
+If any new keys are needed that were not included in Plan 01's locale files, add them to the appropriate en/*.json file as part of this task.
+  </action>
+  <acceptance_criteria>
+    - TopNav.tsx contains `useTranslation` import and `t(` calls
+    - BottomTabBar.tsx contains `useTranslation` import and `t(` calls for all tab labels
+    - FabMenu.tsx contains `useTranslation` import and `t(` calls
+    - UserMenu.tsx contains `useTranslation` import and `t(` calls
+    - __root.tsx contains `useTranslation` import and `t(` calls for dialog text
+    - No hardcoded English nav/tab labels remain in these 5 files
+    - `bun run build` succeeds
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && for f in TopNav BottomTabBar FabMenu UserMenu; do grep -c "useTranslation" src/client/components/$f.tsx; done && grep -c "useTranslation" src/client/routes/__root.tsx</automated>
+  </verify>
+  <done>Navigation and global UI components fully internationalized</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Extract strings from collection and item components</name>
+  <files>src/client/components/CollectionView.tsx, src/client/components/ItemCard.tsx, src/client/components/ItemForm.tsx, src/client/components/CategoryPicker.tsx, src/client/components/CategoryHeader.tsx, src/client/components/WeightSummaryCard.tsx, src/client/components/PlanningView.tsx, src/client/components/TotalsBar.tsx, src/client/components/DashboardCard.tsx, src/client/components/ClassificationBadge.tsx, src/client/components/ImageUpload.tsx, src/client/components/GearImage.tsx, src/client/components/GlobalItemCard.tsx, src/client/components/ManualEntryForm.tsx, src/client/components/LinkToGlobalItem.tsx, src/client/components/CategoryFilterDropdown.tsx, src/client/components/ItemPicker.tsx, src/client/components/ProfileSection.tsx</files>
+  <read_first>src/client/components/CollectionView.tsx, src/client/components/ItemCard.tsx, src/client/components/ItemForm.tsx, src/client/components/CategoryPicker.tsx, src/client/components/CategoryHeader.tsx, src/client/components/WeightSummaryCard.tsx, src/client/components/PlanningView.tsx, src/client/components/TotalsBar.tsx, src/client/components/DashboardCard.tsx, src/client/components/ClassificationBadge.tsx, src/client/components/ImageUpload.tsx, src/client/components/GlobalItemCard.tsx, src/client/components/ManualEntryForm.tsx, src/client/components/LinkToGlobalItem.tsx, src/client/components/CategoryFilterDropdown.tsx, src/client/components/ItemPicker.tsx, src/client/components/ProfileSection.tsx, src/client/locales/en/collection.json, src/client/locales/en/common.json</read_first>
+  <behavior>
+    - All listed components import { useTranslation } from "react-i18next"
+    - Each component uses const { t } = useTranslation("collection") (or "common" for shared strings)
+    - Headings like "Your Collection", "Items", "Weight Summary" use t() calls
+    - Form labels like "Name", "Brand", "Model", "Weight", "Price", "Notes" use t() calls
+    - Empty states like "No items yet" use t() calls
+    - Action buttons already covered by common namespace t() calls
+    - Weight classification labels ("Ultralight", "Light", "Medium", "Heavy") use t() calls
+    - User-generated content (item names, category names) is NOT wrapped in t()
+  </behavior>
+  <action>
+For each component in the files list:
+1. Add `import { useTranslation } from "react-i18next"` 
+2. Add `const { t } = useTranslation("collection")` (or `["collection", "common"]` for components that need both namespaces)
+3. Replace every hardcoded English string with the corresponding `t()` call
+
+**Key mappings (use namespace-prefixed keys when mixing namespaces):**
+
+Collection components use `collection` namespace:
+- Headings: `t("title")`, `t("gear")`, `t("planning")`
+- Empty states: `t("empty.noItems")`, `t("empty.noCategories")`
+- Item form labels: `t("form.name")`, `t("form.brand")`, `t("form.model")`, `t("form.weight")`, `t("form.price")`, `t("form.notes")`, `t("form.category")`
+- Item form placeholders
+- Weight summary labels
+- Classification badges: `t("classification.ultralight")`, etc.
+- Totals: `t("totals.totalWeight")`, `t("totals.totalPrice")`, `t("totals.itemCount")`
+
+Common-namespace strings (buttons, actions) accessed via `t("common:actions.save")` or by passing array `["collection", "common"]`.
+
+**For components that only use common strings** (like ImageUpload, GearImage): use `useTranslation("common")`.
+
+**If a component has no translatable strings** (purely renders user data with no UI chrome), skip it — do NOT add unnecessary imports.
+
+Add any new keys needed to `src/client/locales/en/collection.json` and `src/client/locales/en/common.json`.
+  </action>
+  <acceptance_criteria>
+    - CollectionView.tsx contains useTranslation import and t() calls
+    - ItemForm.tsx uses t() for all form labels (name, brand, model, weight, price, notes)
+    - CategoryPicker.tsx uses t() for search placeholder and "Create category" text
+    - WeightSummaryCard.tsx uses t() for summary labels
+    - ClassificationBadge.tsx uses t() for classification names
+    - No hardcoded English strings remain in UI chrome of these components
+    - `bun run build` succeeds
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && for f in CollectionView ItemCard ItemForm CategoryPicker WeightSummaryCard; do echo -n "$f: "; grep -c "useTranslation" src/client/components/$f.tsx; done</automated>
+  </verify>
+  <done>Collection and item components fully internationalized</done>
+</task>
+
+<task type="auto">
+  <name>Task 3: Extract strings from thread and candidate components</name>
+  <files>src/client/components/ThreadCard.tsx, src/client/components/ThreadTabs.tsx, src/client/components/CandidateCard.tsx, src/client/components/CandidateForm.tsx, src/client/components/CandidateListItem.tsx, src/client/components/ComparisonTable.tsx, src/client/components/CreateThreadModal.tsx, src/client/components/StatusBadge.tsx, src/client/components/AddToThreadModal.tsx</files>
+  <read_first>src/client/components/ThreadCard.tsx, src/client/components/ThreadTabs.tsx, src/client/components/CandidateCard.tsx, src/client/components/CandidateForm.tsx, src/client/components/CandidateListItem.tsx, src/client/components/ComparisonTable.tsx, src/client/components/CreateThreadModal.tsx, src/client/components/StatusBadge.tsx, src/client/components/AddToThreadModal.tsx, src/client/locales/en/threads.json</read_first>
+  <behavior>
+    - All listed components import useTranslation from react-i18next
+    - Thread components use "threads" namespace
+    - Status labels ("Active", "Resolved", "Archived") use t() calls
+    - Thread creation modal labels use t() calls
+    - Candidate form labels use t() calls
+    - Comparison table headers use t() calls
+    - Thread/candidate names are NOT wrapped in t() (user-generated content)
+  </behavior>
+  <action>
+For each component:
+1. Add `import { useTranslation } from "react-i18next"`
+2. Add `const { t } = useTranslation("threads")` (or `["threads", "common"]`)
+3. Replace all hardcoded English UI chrome strings with t() calls
+
+**Key mappings for threads namespace:**
+- Status: `t("status.active")`, `t("status.resolved")`, `t("status.archived")`
+- Create modal: `t("create.title")`, `t("create.namePlaceholder")`, `t("create.description")`
+- Candidate form: `t("candidate.name")`, `t("candidate.price")`, `t("candidate.weight")`, `t("candidate.url")`, `t("candidate.pros")`, `t("candidate.cons")`, `t("candidate.notes")`
+- Comparison headers: `t("comparison.weight")`, `t("comparison.price")`, `t("comparison.pros")`, `t("comparison.cons")`
+- Actions: use common namespace for buttons
+
+Add any new keys to `src/client/locales/en/threads.json`.
+  </action>
+  <acceptance_criteria>
+    - ThreadCard.tsx contains useTranslation import and t() calls
+    - CandidateForm.tsx uses t() for all form labels
+    - ComparisonTable.tsx uses t() for column headers
+    - StatusBadge.tsx uses t() for status labels
+    - CreateThreadModal.tsx uses t() for modal title and form labels
+    - No hardcoded English status labels remain
+    - `bun run build` succeeds
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && for f in ThreadCard CandidateForm ComparisonTable StatusBadge CreateThreadModal; do echo -n "$f: "; grep -c "useTranslation" src/client/components/$f.tsx; done</automated>
+  </verify>
+  <done>Thread and candidate components fully internationalized</done>
+</task>
+
+<task type="auto">
+  <name>Task 4: Extract strings from setup, modal, and route components</name>
+  <files>src/client/components/SetupsView.tsx, src/client/components/SetupCard.tsx, src/client/components/SetupImpactSelector.tsx, src/client/components/ShareModal.tsx, src/client/components/PublicSetupCard.tsx, src/client/components/ImpactDeltaBadge.tsx, src/client/components/ConfirmDialog.tsx, src/client/components/ExternalLinkDialog.tsx, src/client/components/AddToCollectionModal.tsx, src/client/components/SlideOutPanel.tsx, src/client/routes/index.tsx, src/client/routes/login.tsx, src/client/routes/profile.tsx, src/client/routes/collection/index.tsx, src/client/routes/collection/gear.tsx, src/client/routes/items/$itemId.tsx, src/client/routes/threads/index.tsx, src/client/routes/threads/$threadId.tsx, src/client/routes/setups/$setupId.tsx, src/client/routes/global-items/index.tsx, src/client/routes/global-items/$itemId.tsx, src/client/routes/users/$userId.tsx</files>
+  <read_first>src/client/components/SetupsView.tsx, src/client/components/SetupCard.tsx, src/client/components/SetupImpactSelector.tsx, src/client/components/ShareModal.tsx, src/client/components/PublicSetupCard.tsx, src/client/components/ConfirmDialog.tsx, src/client/components/ExternalLinkDialog.tsx, src/client/components/AddToCollectionModal.tsx, src/client/routes/index.tsx, src/client/routes/login.tsx, src/client/routes/profile.tsx, src/client/routes/collection/index.tsx, src/client/routes/items/$itemId.tsx, src/client/routes/threads/index.tsx, src/client/routes/threads/$threadId.tsx, src/client/routes/setups/$setupId.tsx, src/client/routes/global-items/index.tsx, src/client/routes/global-items/$itemId.tsx, src/client/routes/users/$userId.tsx, src/client/locales/en/setups.json, src/client/locales/en/common.json</read_first>
+  <behavior>
+    - Setup components use "setups" namespace for setup-specific strings
+    - Modal/dialog components use "common" namespace
+    - Route pages use their respective namespace (collection routes use "collection", thread routes use "threads", etc.)
+    - Landing page (index.tsx) strings use "common" namespace
+    - Login page strings use "common" namespace
+    - All user-generated content (setup names, thread titles, user names) is NOT wrapped in t()
+  </behavior>
+  <action>
+For each component/route:
+1. Add `import { useTranslation } from "react-i18next"`
+2. Add `const { t } = useTranslation(...)` with appropriate namespace
+3. Replace all hardcoded English UI chrome strings with t() calls
+
+**Setup namespace keys:**
+- `t("title")`, `t("create")`, `t("empty")`, `t("card.items")`, `t("card.weight")`, `t("card.price")`
+- Share: `t("share.title")`, `t("share.copyLink")`, `t("share.copied")`
+- Impact: `t("impact.title")`, `t("impact.adding")`, `t("impact.removing")`
+
+**Common namespace for modals/dialogs:**
+- ConfirmDialog: `t("confirm.title")`, `t("confirm.message")`
+- ExternalLinkDialog: `t("externalLink.title")`, `t("externalLink.message")`
+- AddToCollectionModal: `t("addToCollection.title")`
+
+**Route pages:** Use the matching namespace. Page-level headings and descriptions get t() calls. Links back ("Back") use `t("common:actions.back")`.
+
+Add any new keys to the appropriate en/*.json files.
+  </action>
+  <acceptance_criteria>
+    - SetupsView.tsx contains useTranslation import
+    - SetupCard.tsx uses t() for card labels
+    - ShareModal.tsx uses t() for share dialog text
+    - ConfirmDialog.tsx uses t() for confirmation dialog text
+    - Login page (routes/login.tsx) uses t() for login page text
+    - Landing page (routes/index.tsx) uses t() for discovery page text
+    - Route pages use appropriate namespaces
+    - `bun run build` succeeds
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && grep -rl "useTranslation" src/client/components/ src/client/routes/ | wc -l</automated>
+  </verify>
+  <done>Setups, modals, dialogs, and all route pages fully internationalized</done>
+</task>
+
+<task type="auto">
+  <name>Task 5: Extract strings from onboarding and settings components</name>
+  <files>src/client/components/onboarding/OnboardingWelcome.tsx, src/client/components/onboarding/OnboardingHobbyPicker.tsx, src/client/components/onboarding/OnboardingItemBrowser.tsx, src/client/components/onboarding/OnboardingReview.tsx, src/client/components/onboarding/OnboardingDone.tsx, src/client/components/onboarding/OnboardingFlow.tsx, src/client/components/onboarding/StepIndicator.tsx, src/client/components/onboarding/HobbyCard.tsx, src/client/components/onboarding/SelectableItemCard.tsx, src/client/routes/settings.tsx</files>
+  <read_first>src/client/components/onboarding/OnboardingWelcome.tsx, src/client/components/onboarding/OnboardingHobbyPicker.tsx, src/client/components/onboarding/OnboardingItemBrowser.tsx, src/client/components/onboarding/OnboardingReview.tsx, src/client/components/onboarding/OnboardingDone.tsx, src/client/components/onboarding/OnboardingFlow.tsx, src/client/components/onboarding/StepIndicator.tsx, src/client/components/onboarding/HobbyCard.tsx, src/client/components/onboarding/SelectableItemCard.tsx, src/client/routes/settings.tsx, src/client/locales/en/onboarding.json, src/client/locales/en/settings.json</read_first>
+  <behavior>
+    - Onboarding components use "onboarding" namespace
+    - Welcome screen: title, subtitle, CTA button text use t()
+    - Hobby picker: heading, description use t() (hobby names MAY be translatable if they are system-defined)
+    - Item browser: heading, description, search placeholder use t()
+    - Review: heading, description use t()
+    - Done: heading, description, CTA button use t()
+    - Settings page uses "settings" namespace
+    - Settings labels (Weight Unit, Currency, API Keys, Import/Export) use t()
+    - Settings descriptions use t()
+  </behavior>
+  <action>
+For each onboarding component:
+1. Add `import { useTranslation } from "react-i18next"`
+2. Add `const { t } = useTranslation("onboarding")`
+3. Replace all hardcoded strings with t() calls
+
+**Onboarding namespace keys:**
+- Welcome: `t("welcome.title")`, `t("welcome.subtitle")`, `t("welcome.cta")`
+- HobbyPicker: `t("hobby.title")`, `t("hobby.subtitle")`, `t("hobby.next")`
+- ItemBrowser: `t("items.title")`, `t("items.subtitle")`, `t("items.searchPlaceholder")`, `t("items.next")`
+- Review: `t("review.title")`, `t("review.subtitle")`
+- Done: `t("done.title")`, `t("done.subtitle")`, `t("done.cta")`
+- Step indicators: `t("step.of", { current: 1, total: 5 })`
+
+For settings.tsx:
+1. Add `import { useTranslation } from "react-i18next"`
+2. Add `const { t } = useTranslation("settings")`
+3. Replace settings labels:
+   - "Settings" heading: `t("title")`
+   - "Back": use `t("common:actions.back")` 
+   - "Weight Unit" label: `t("weightUnit.title")`
+   - "Choose the unit used to display weights across the app": `t("weightUnit.description")`
+   - "Currency" label: `t("currency.title")`
+   - "Changes the currency symbol displayed. This does not convert values.": `t("currency.description")`
+   - "API Keys" heading: `t("apiKeys.title")`
+   - "API keys allow programmatic access...": `t("apiKeys.description")`
+   - "Copy this key now — it won't be shown again:": `t("apiKeys.copyWarning")`
+   - "Dismiss": `t("common:actions.dismiss")`
+   - "Key name (e.g., claude-desktop)": `t("apiKeys.namePlaceholder")`
+   - "Create": `t("common:actions.create")`
+   - "Revoke": `t("apiKeys.revoke")`
+   - "Import / Export" heading: `t("importExport.title")`
+   - "Export your gear collection as a CSV...": `t("importExport.description")`
+   - "Export CSV": `t("importExport.export")`
+   - "Import CSV": `t("importExport.import")`
+   - "Importing...": `t("importExport.importing")`
+   - Import result messages
+
+Add any new keys to the appropriate en/*.json files.
+  </action>
+  <acceptance_criteria>
+    - All 9 onboarding component files contain useTranslation import
+    - OnboardingWelcome.tsx uses t() for title, subtitle, and CTA
+    - OnboardingDone.tsx uses t() for done screen text
+    - settings.tsx uses t() for all section headings, labels, descriptions
+    - settings.tsx "Weight Unit" label uses `t("weightUnit.title")`
+    - settings.tsx "API Keys" section uses `t("apiKeys.title")`
+    - No hardcoded English strings remain in onboarding or settings UI chrome
+    - `bun run build` succeeds
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && grep -c "useTranslation" src/client/routes/settings.tsx && for f in OnboardingWelcome OnboardingHobbyPicker OnboardingItemBrowser OnboardingReview OnboardingDone; do echo -n "$f: "; grep -c "useTranslation" src/client/components/onboarding/$f.tsx; done</automated>
+  </verify>
+  <done>Onboarding flow and settings page fully internationalized</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| translation files→DOM | Translation strings rendered in JSX — React escapes by default |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-34-03 | Injection | t() output in JSX | accept | i18next interpolation escapeValue is false BUT React's JSX escaping prevents XSS. Translation strings are bundled static content, not user input. |
+</threat_model>
+
+<verification>
+- `bun run build` succeeds
+- grep -rl "useTranslation" finds matches in all major component and route files
+- No hardcoded English UI chrome strings remain in extracted components
+</verification>
+
+<success_criteria>
+- All UI components use useTranslation() hook
+- All hardcoded English strings replaced with t() calls
+- User-generated content is NOT wrapped in t()
+- Build passes
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/34-i18n-foundation/34-02-SUMMARY.md`
+</output>

.planning/phases/34-i18n-foundation/34-03-PLAN.md

@@ -0,0 +1,467 @@
+---
+phase: 34-i18n-foundation
+plan: 03
+type: execute
+wave: 2
+depends_on: [01, 02]
+files_modified:
+  - src/client/lib/formatters.ts
+  - src/client/hooks/useFormatters.ts
+  - src/client/hooks/useLanguage.ts
+  - tests/formatters.test.ts
+autonomous: true
+requirements: [D-04, D-09, D-10]
+
+must_haves:
+  truths:
+    - "formatPrice() uses Intl.NumberFormat with locale parameter for locale-aware currency display"
+    - "formatWeight() uses locale parameter for locale-aware number formatting"
+    - "useFormatters() hook returns locale-aware weight and price formatters"
+    - "useLanguage() hook reads language from settings and returns the current locale string"
+    - "German locale formats prices as '1.234,56 EUR' not '$1,234.56'"
+    - "English locale formats prices as '$1,234.56' not '1.234,56 EUR'"
+  artifacts:
+    - path: "src/client/lib/formatters.ts"
+      provides: "Locale-aware formatWeight and formatPrice functions"
+      contains: "Intl.NumberFormat"
+    - path: "src/client/hooks/useLanguage.ts"
+      provides: "Language preference hook"
+      exports: ["useLanguage"]
+    - path: "src/client/hooks/useFormatters.ts"
+      provides: "Extended formatters with locale"
+      contains: "useLanguage"
+    - path: "tests/formatters.test.ts"
+      provides: "Tests for locale-aware formatting"
+      min_lines: 30
+  key_links:
+    - from: "src/client/hooks/useFormatters.ts"
+      to: "src/client/hooks/useLanguage.ts"
+      via: "useLanguage() import"
+      pattern: "useLanguage"
+---
+
+<objective>
+Make weight and price formatting locale-aware and create the useLanguage() hook.
+
+Purpose: Formatting integration — numbers, currencies, and weights display according to the user's locale (e.g., German: "1.234,56 EUR" vs English: "$1,234.56").
+Output: Locale-aware formatters, useLanguage hook, formatter tests.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/34-i18n-foundation/34-CONTEXT.md
+@.planning/phases/34-i18n-foundation/34-RESEARCH.md
+
+<interfaces>
+Current formatters.ts:
+```typescript
+export type WeightUnit = "g" | "oz" | "lb" | "kg";
+export function formatWeight(grams: number | null | undefined, unit: WeightUnit = "g"): string { ... }
+export type Currency = "USD" | "EUR" | "GBP" | "JPY" | "CAD" | "AUD";
+export function formatPrice(cents: number | null | undefined, currency: Currency = "USD"): string { ... }
+```
+
+Current useFormatters.ts:
+```typescript
+export function useFormatters() {
+  const unit = useWeightUnit();
+  const currency = useCurrency();
+  return {
+    weight: (grams: number | null) => formatWeight(grams, unit),
+    price: (cents: number | null) => formatPrice(cents, currency),
+    unit,
+    currency,
+  };
+}
+```
+
+Current useWeightUnit.ts pattern:
+```typescript
+export function useWeightUnit(): WeightUnit {
+  const { data } = useSetting("weightUnit");
+  if (data && VALID_UNITS.includes(data as WeightUnit)) return data as WeightUnit;
+  return "g";
+}
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto" tdd="true">
+  <name>Task 1: Create useLanguage hook</name>
+  <files>src/client/hooks/useLanguage.ts</files>
+  <read_first>src/client/hooks/useWeightUnit.ts, src/client/hooks/useCurrency.ts, src/client/hooks/useSettings.ts</read_first>
+  <behavior>
+    - useLanguage() reads from useSetting("language")
+    - Returns "en" when setting is null, undefined, or invalid
+    - Returns "de" when setting value is "de"
+    - Validates against VALID_LANGUAGES array ["en", "de"]
+    - Exports VALID_LANGUAGES array
+  </behavior>
+  <action>
+Create `src/client/hooks/useLanguage.ts`:
+
+```typescript
+import { useSetting } from "./useSettings";
+
+export const VALID_LANGUAGES = ["en", "de"] as const;
+export type Language = (typeof VALID_LANGUAGES)[number];
+
+export function useLanguage(): Language {
+	const { data } = useSetting("language");
+	if (data && VALID_LANGUAGES.includes(data as Language)) {
+		return data as Language;
+	}
+	return "en";
+}
+```
+
+This follows the exact same pattern as `useWeightUnit()` and `useCurrency()` per established project conventions.
+  </action>
+  <acceptance_criteria>
+    - src/client/hooks/useLanguage.ts exists
+    - File exports useLanguage function
+    - File exports VALID_LANGUAGES array containing "en" and "de"
+    - useLanguage returns "en" as default fallback
+    - Pattern matches useWeightUnit (useSetting, validation, default)
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && grep -c "useLanguage\|VALID_LANGUAGES\|useSetting" src/client/hooks/useLanguage.ts</automated>
+  </verify>
+  <done>useLanguage hook created following established settings hook pattern</done>
+</task>
+
+<task type="auto" tdd="true">
+  <name>Task 2: Make formatPrice locale-aware using Intl.NumberFormat</name>
+  <files>src/client/lib/formatters.ts</files>
+  <read_first>src/client/lib/formatters.ts</read_first>
+  <behavior>
+    - formatPrice gains a third parameter: locale (string, defaults to "en")
+    - formatPrice uses new Intl.NumberFormat(locale, { style: "currency", currency }) instead of manual symbol lookup
+    - formatPrice("en", "USD", 123456) returns "$1,234.56"
+    - formatPrice("de", "EUR", 123456) returns "1.234,56 €"
+    - formatPrice("en", "JPY", 10000) returns "¥100" (no decimals)
+    - formatPrice(null) still returns "--"
+    - CURRENCY_SYMBOLS constant can be removed (Intl handles symbols)
+  </behavior>
+  <action>
+Update `src/client/lib/formatters.ts`:
+
+Replace the `formatPrice` function with:
+
+```typescript
+export function formatPrice(
+	cents: number | null | undefined,
+	currency: Currency = "USD",
+	locale = "en",
+): string {
+	if (cents == null) return "--";
+	return new Intl.NumberFormat(locale, {
+		style: "currency",
+		currency,
+		minimumFractionDigits: currency === "JPY" ? 0 : 2,
+		maximumFractionDigits: currency === "JPY" ? 0 : 2,
+	}).format(cents / 100);
+}
+```
+
+Remove the `CURRENCY_SYMBOLS` constant and its `Record<Currency, string>` type — they are replaced by `Intl.NumberFormat`.
+
+Keep the `Currency` type export and the existing values ("USD", "EUR", "GBP", "JPY", "CAD", "AUD").
+
+**NOTE:** The `locale` parameter defaults to `"en"` so existing callers that don't pass locale continue to work (backward compatible).
+  </action>
+  <acceptance_criteria>
+    - formatPrice function signature has 3 parameters: cents, currency, locale
+    - formatPrice contains `new Intl.NumberFormat(locale`
+    - CURRENCY_SYMBOLS constant is removed from the file
+    - formatPrice(null) returns "--"
+    - formatPrice(12345, "USD", "en") produces "$123.45"
+    - formatPrice(12345, "EUR", "de") produces a string containing "123,45" and "€"
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && grep -c "Intl.NumberFormat" src/client/lib/formatters.ts && grep -c "CURRENCY_SYMBOLS" src/client/lib/formatters.ts</automated>
+  </verify>
+  <done>formatPrice uses Intl.NumberFormat for locale-aware currency formatting</done>
+</task>
+
+<task type="auto" tdd="true">
+  <name>Task 3: Make formatWeight locale-aware</name>
+  <files>src/client/lib/formatters.ts</files>
+  <read_first>src/client/lib/formatters.ts</read_first>
+  <behavior>
+    - formatWeight gains a third parameter: locale (string, defaults to "en")
+    - formatWeight uses Intl.NumberFormat for the number part, then appends the unit suffix
+    - formatWeight(1234, "g", "en") returns "1,234g" (with thousands separator)
+    - formatWeight(1234, "g", "de") returns "1.234g" (German thousands separator is period)
+    - formatWeight(null) still returns "--"
+    - Unit suffixes remain as-is (g, oz, lb, kg are universal abbreviations)
+  </behavior>
+  <action>
+Update `formatWeight` in `src/client/lib/formatters.ts`:
+
+```typescript
+export function formatWeight(
+	grams: number | null | undefined,
+	unit: WeightUnit = "g",
+	locale = "en",
+): string {
+	if (grams == null) return "--";
+	let value: number;
+	let fractionDigits: number;
+	switch (unit) {
+		case "g":
+			value = Math.round(grams);
+			fractionDigits = 0;
+			break;
+		case "oz":
+			value = grams / GRAMS_PER_OZ;
+			fractionDigits = 1;
+			break;
+		case "lb":
+			value = grams / GRAMS_PER_LB;
+			fractionDigits = 2;
+			break;
+		case "kg":
+			value = grams / GRAMS_PER_KG;
+			fractionDigits = 2;
+			break;
+	}
+	const formatted = new Intl.NumberFormat(locale, {
+		minimumFractionDigits: fractionDigits,
+		maximumFractionDigits: fractionDigits,
+	}).format(value);
+	return unit === "g" ? `${formatted}g` : `${formatted} ${unit}`;
+}
+```
+
+This preserves the existing behavior (unit conversion math, decimal places per unit) but adds locale-aware number formatting (thousands separators, decimal separators).
+  </action>
+  <acceptance_criteria>
+    - formatWeight function signature has 3 parameters: grams, unit, locale
+    - formatWeight contains Intl.NumberFormat usage
+    - formatWeight(null) returns "--"
+    - formatWeight(1234, "g", "en") produces a string ending with "g"
+    - formatWeight(1234.5, "kg", "de") uses comma as decimal separator
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && grep -c "Intl.NumberFormat" src/client/lib/formatters.ts</automated>
+  </verify>
+  <done>formatWeight uses Intl.NumberFormat for locale-aware number display</done>
+</task>
+
+<task type="auto" tdd="true">
+  <name>Task 4: Update useFormatters hook to pass locale</name>
+  <files>src/client/hooks/useFormatters.ts</files>
+  <read_first>src/client/hooks/useFormatters.ts, src/client/hooks/useLanguage.ts, src/client/lib/formatters.ts</read_first>
+  <behavior>
+    - useFormatters imports useLanguage
+    - useFormatters calls useLanguage() to get current locale
+    - weight formatter passes locale to formatWeight
+    - price formatter passes locale to formatPrice
+    - useFormatters return object includes locale property
+  </behavior>
+  <action>
+Update `src/client/hooks/useFormatters.ts`:
+
+```typescript
+import { formatPrice, formatWeight } from "../lib/formatters";
+import { useCurrency } from "./useCurrency";
+import { useLanguage } from "./useLanguage";
+import { useWeightUnit } from "./useWeightUnit";
+
+export function useFormatters() {
+	const unit = useWeightUnit();
+	const currency = useCurrency();
+	const locale = useLanguage();
+	return {
+		weight: (grams: number | null) => formatWeight(grams, unit, locale),
+		price: (cents: number | null) => formatPrice(cents, currency, locale),
+		unit,
+		currency,
+		locale,
+	};
+}
+```
+
+This adds `useLanguage` import, passes `locale` to both formatters, and exposes `locale` in the return object for components that need it.
+  </action>
+  <acceptance_criteria>
+    - useFormatters.ts imports useLanguage from "./useLanguage"
+    - useFormatters calls useLanguage()
+    - formatWeight call passes locale as third argument
+    - formatPrice call passes locale as third argument
+    - Return object includes locale property
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && grep -c "useLanguage\|locale" src/client/hooks/useFormatters.ts</automated>
+  </verify>
+  <done>useFormatters hook passes locale to all formatters</done>
+</task>
+
+<task type="auto" tdd="true">
+  <name>Task 5: Write tests for locale-aware formatters</name>
+  <files>tests/formatters.test.ts</files>
+  <read_first>src/client/lib/formatters.ts, tests/services/item.service.test.ts</read_first>
+  <behavior>
+    - Tests verify formatPrice with "en" locale produces "$" prefix for USD
+    - Tests verify formatPrice with "de" locale produces "€" suffix for EUR
+    - Tests verify formatPrice handles null input
+    - Tests verify formatPrice handles JPY (no decimals)
+    - Tests verify formatWeight with "en" locale uses comma for thousands
+    - Tests verify formatWeight with "de" locale uses period for thousands
+    - Tests verify formatWeight handles null input
+    - Tests verify formatWeight unit conversions still correct
+  </behavior>
+  <action>
+Create `tests/formatters.test.ts`:
+
+```typescript
+import { describe, expect, test } from "bun:test";
+import { formatPrice, formatWeight } from "../src/client/lib/formatters";
+
+describe("formatPrice", () => {
+	test("returns -- for null", () => {
+		expect(formatPrice(null)).toBe("--");
+	});
+
+	test("returns -- for undefined", () => {
+		expect(formatPrice(undefined)).toBe("--");
+	});
+
+	test("formats USD with en locale", () => {
+		const result = formatPrice(12345, "USD", "en");
+		expect(result).toContain("123.45");
+		expect(result).toContain("$");
+	});
+
+	test("formats EUR with de locale", () => {
+		const result = formatPrice(12345, "EUR", "de");
+		expect(result).toContain("123,45");
+		expect(result).toContain("€");
+	});
+
+	test("formats JPY with no decimals", () => {
+		const result = formatPrice(10000, "JPY", "en");
+		expect(result).toContain("100");
+		expect(result).toContain("¥");
+		expect(result).not.toContain(".");
+	});
+
+	test("formats large amounts with thousands separator en", () => {
+		const result = formatPrice(123456789, "USD", "en");
+		expect(result).toContain("1,234,567.89");
+	});
+
+	test("formats large amounts with thousands separator de", () => {
+		const result = formatPrice(123456789, "EUR", "de");
+		// German uses period for thousands and comma for decimal
+		expect(result).toContain("1.234.567,89");
+	});
+
+	test("defaults to en locale when no locale provided", () => {
+		const result = formatPrice(12345, "USD");
+		expect(result).toContain("$");
+		expect(result).toContain("123.45");
+	});
+});
+
+describe("formatWeight", () => {
+	test("returns -- for null", () => {
+		expect(formatWeight(null)).toBe("--");
+	});
+
+	test("returns -- for undefined", () => {
+		expect(formatWeight(undefined)).toBe("--");
+	});
+
+	test("formats grams with en locale", () => {
+		expect(formatWeight(1234, "g", "en")).toBe("1,234g");
+	});
+
+	test("formats grams with de locale", () => {
+		expect(formatWeight(1234, "g", "de")).toBe("1.234g");
+	});
+
+	test("formats ounces", () => {
+		const result = formatWeight(100, "oz", "en");
+		expect(result).toContain("oz");
+		expect(result).toContain("3.5");
+	});
+
+	test("formats kilograms", () => {
+		const result = formatWeight(1500, "kg", "en");
+		expect(result).toContain("1.50");
+		expect(result).toContain("kg");
+	});
+
+	test("formats pounds", () => {
+		const result = formatWeight(1000, "lb", "en");
+		expect(result).toContain("lb");
+		expect(result).toContain("2.2");
+	});
+
+	test("defaults to en locale when no locale provided", () => {
+		const result = formatWeight(1234, "g");
+		expect(result).toBe("1,234g");
+	});
+});
+```
+
+**NOTE:** Intl.NumberFormat output may vary slightly between JS engines (Bun uses JavaScriptCore). The tests use `toContain` for flexible matching where exact format may vary, and `toBe` only where the format is deterministic.
+  </action>
+  <acceptance_criteria>
+    - tests/formatters.test.ts exists
+    - File contains at least 14 test cases (7 for formatPrice, 7 for formatWeight)
+    - Tests cover null input, en locale, de locale, default locale
+    - `bun test tests/formatters.test.ts` passes
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && bun test tests/formatters.test.ts</automated>
+  </verify>
+  <done>Formatter tests pass for both locales</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| settings DB→useLanguage | Language preference from DB — validated against VALID_LANGUAGES |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-34-04 | Tampering | useLanguage | mitigate | Validates language value against VALID_LANGUAGES array before returning; invalid values fall back to "en" |
+</threat_model>
+
+<verification>
+- `bun test tests/formatters.test.ts` passes
+- `bun run build` succeeds
+- formatPrice produces locale-appropriate output for en and de
+- formatWeight produces locale-appropriate output for en and de
+- useFormatters hook passes locale to both formatters
+</verification>
+
+<success_criteria>
+- formatPrice uses Intl.NumberFormat for locale-aware formatting
+- formatWeight uses Intl.NumberFormat for locale-aware number display
+- useLanguage hook reads language from settings with "en" fallback
+- useFormatters hook passes locale to formatters
+- All formatter tests pass
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/34-i18n-foundation/34-03-SUMMARY.md`
+</output>

.planning/phases/34-i18n-foundation/34-04-PLAN.md

@@ -0,0 +1,291 @@
+---
+phase: 34-i18n-foundation
+plan: 04
+type: execute
+wave: 2
+depends_on: [01, 03]
+files_modified:
+  - src/client/routes/settings.tsx
+  - src/client/routes/__root.tsx
+  - src/client/lib/i18n.ts
+autonomous: true
+requirements: [D-09, D-10, D-11, D-12]
+
+must_haves:
+  truths:
+    - "Language picker appears in settings page with English and Deutsch options"
+    - "Language picker uses the pill-toggle pattern matching weight unit and currency pickers"
+    - "Selecting a language persists via updateSetting('language', value)"
+    - "Selecting a language calls i18n.changeLanguage(value) to update the UI immediately"
+    - "Language picker is placed above weight unit in settings page"
+    - "Browser auto-detection works on first visit (navigator.language)"
+    - "Unknown browser locales fall back to English"
+  artifacts:
+    - path: "src/client/routes/settings.tsx"
+      provides: "Language picker UI"
+      contains: "language"
+    - path: "src/client/routes/__root.tsx"
+      provides: "i18n language sync with settings"
+      contains: "changeLanguage"
+  key_links:
+    - from: "src/client/routes/settings.tsx"
+      to: "src/client/hooks/useLanguage.ts"
+      via: "useLanguage() import"
+      pattern: "useLanguage"
+    - from: "src/client/routes/__root.tsx"
+      to: "src/client/lib/i18n.ts"
+      via: "i18n.changeLanguage"
+      pattern: "changeLanguage"
+---
+
+<objective>
+Add language picker to settings page and wire language changes to i18n instance.
+
+Purpose: User controls — users can see their current language, change it, and the UI updates immediately.
+Output: Language picker in settings, i18n sync on language change, browser auto-detection on first visit.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/34-i18n-foundation/34-CONTEXT.md
+@.planning/phases/34-i18n-foundation/34-RESEARCH.md
+
+<interfaces>
+Current settings.tsx pill-toggle pattern (weight unit):
+```tsx
+<div className="flex items-center justify-between">
+  <div>
+    <h3 className="text-sm font-medium text-gray-900">Weight Unit</h3>
+    <p className="text-xs text-gray-500 mt-0.5">
+      Choose the unit used to display weights across the app
+    </p>
+  </div>
+  <div className="flex items-center gap-1 bg-gray-100 rounded-full px-1 py-0.5">
+    {UNITS.map((u) => (
+      <button key={u} type="button"
+        onClick={() => updateSetting.mutate({ key: "weightUnit", value: u })}
+        className={`px-2.5 py-1 text-xs rounded-full transition-colors ${
+          unit === u
+            ? "bg-white text-gray-700 shadow-sm font-medium"
+            : "text-gray-400 hover:text-gray-600"
+        }`}>
+        {u}
+      </button>
+    ))}
+  </div>
+</div>
+```
+
+useLanguage hook (from Plan 03):
+```typescript
+export const VALID_LANGUAGES = ["en", "de"] as const;
+export type Language = (typeof VALID_LANGUAGES)[number];
+export function useLanguage(): Language { ... }
+```
+
+i18n instance:
+```typescript
+import i18n from "../lib/i18n";
+i18n.changeLanguage("de"); // switches language
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Add language picker to settings page</name>
+  <files>src/client/routes/settings.tsx</files>
+  <read_first>src/client/routes/settings.tsx, src/client/hooks/useLanguage.ts, src/client/locales/en/settings.json</read_first>
+  <behavior>
+    - Settings page imports useLanguage from hooks/useLanguage
+    - Settings page imports i18n from lib/i18n
+    - Language picker section appears ABOVE the weight unit section (first preference in the list)
+    - Language picker uses the same pill-toggle pattern as weight unit and currency
+    - Options: "English" (value: "en") and "Deutsch" (value: "de")
+    - Clicking an option calls updateSetting.mutate({ key: "language", value }) AND i18n.changeLanguage(value)
+    - Active language is highlighted with the same styling pattern
+    - Label and description use t() keys from settings namespace
+  </behavior>
+  <action>
+Update `src/client/routes/settings.tsx`:
+
+1. Add imports:
+```typescript
+import i18n from "../lib/i18n";
+import { useLanguage } from "../hooks/useLanguage";
+```
+
+2. In the `SettingsPage` component, add after `const updateSetting = useUpdateSetting();`:
+```typescript
+const language = useLanguage();
+```
+
+3. Add a `LANGUAGES` constant at the top of the file (near UNITS and CURRENCIES):
+```typescript
+const LANGUAGES = [
+  { value: "en", label: "English" },
+  { value: "de", label: "Deutsch" },
+];
+```
+
+4. Add the language picker section BEFORE the weight unit section (first item in the settings card). It uses the same pill-toggle pattern:
+
+```tsx
+<div className="flex items-center justify-between">
+  <div>
+    <h3 className="text-sm font-medium text-gray-900">{t("language.title")}</h3>
+    <p className="text-xs text-gray-500 mt-0.5">
+      {t("language.description")}
+    </p>
+  </div>
+  <div className="flex items-center gap-1 bg-gray-100 rounded-full px-1 py-0.5">
+    {LANGUAGES.map((lang) => (
+      <button
+        key={lang.value}
+        type="button"
+        onClick={() => {
+          updateSetting.mutate({ key: "language", value: lang.value });
+          i18n.changeLanguage(lang.value);
+        }}
+        className={`px-2.5 py-1 text-xs rounded-full transition-colors ${
+          language === lang.value
+            ? "bg-white text-gray-700 shadow-sm font-medium"
+            : "text-gray-400 hover:text-gray-600"
+        }`}
+      >
+        {lang.label}
+      </button>
+    ))}
+  </div>
+</div>
+
+<div className="border-t border-gray-100" />
+```
+
+5. Add these keys to `src/client/locales/en/settings.json` if not already present:
+```json
+{
+  "language": {
+    "title": "Language",
+    "description": "Change the display language of the app"
+  }
+}
+```
+
+**NOTE:** Language labels ("English", "Deutsch") are intentionally NOT translated — they should always appear in their native language so users can identify their language even when the UI is in another language.
+  </action>
+  <acceptance_criteria>
+    - settings.tsx imports useLanguage and i18n
+    - settings.tsx has LANGUAGES constant with "en"/"English" and "de"/"Deutsch"
+    - Language picker section appears before weight unit section
+    - onClick handler calls both updateSetting.mutate and i18n.changeLanguage
+    - Language labels use native names ("English", "Deutsch"), not translated
+    - Pill-toggle styling matches weight unit and currency pickers
+    - settings.json has language.title and language.description keys
+    - `bun run build` succeeds
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && grep -c "useLanguage\|changeLanguage\|LANGUAGES" src/client/routes/settings.tsx</automated>
+  </verify>
+  <done>Language picker added to settings matching existing preference UI pattern</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Sync i18n language with settings on app load</name>
+  <files>src/client/routes/__root.tsx</files>
+  <read_first>src/client/routes/__root.tsx, src/client/hooks/useLanguage.ts, src/client/lib/i18n.ts</read_first>
+  <behavior>
+    - RootLayout component syncs i18n language when useLanguage() value changes
+    - On first load, if user has a saved language preference, i18n switches to it
+    - If no saved preference, i18n uses the browser-detected language (already configured in i18n.ts detection)
+    - useEffect watches language value and calls i18n.changeLanguage when it changes
+    - This handles the case where a user has "de" saved in settings but i18n initially detected "en" from browser
+  </behavior>
+  <action>
+Update `src/client/routes/__root.tsx`:
+
+1. Add imports:
+```typescript
+import { useEffect } from "react";
+import { useTranslation } from "react-i18next";
+import { useLanguage } from "../hooks/useLanguage";
+```
+
+Note: `useState` is already imported. Check if `useEffect` is already imported — if not, add it.
+
+2. In the `RootLayout` function, add after existing hooks:
+```typescript
+const language = useLanguage();
+const { i18n } = useTranslation();
+
+useEffect(() => {
+  if (language && i18n.language !== language) {
+    i18n.changeLanguage(language);
+  }
+}, [language, i18n]);
+```
+
+This syncs the i18n instance with the persisted language setting. On first load:
+- i18next's LanguageDetector picks browser locale or localStorage cache
+- useSetting("language") resolves from the DB
+- If they differ, useEffect syncs i18n to the DB value (DB is source of truth)
+
+On subsequent language changes via settings:
+- updateSetting immediately calls i18n.changeLanguage (in settings.tsx)
+- useLanguage() updates via React Query invalidation
+- useEffect acts as a safety net if the values drift
+  </action>
+  <acceptance_criteria>
+    - __root.tsx imports useLanguage from hooks/useLanguage
+    - __root.tsx imports useTranslation from react-i18next
+    - RootLayout has useEffect that calls i18n.changeLanguage(language)
+    - useEffect depends on [language, i18n]
+    - `bun run build` succeeds
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && grep -c "useLanguage\|changeLanguage\|useTranslation" src/client/routes/__root.tsx</automated>
+  </verify>
+  <done>Language syncs between settings DB and i18n instance on load and change</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| settings API→i18n | Language value from DB flows into i18n.changeLanguage — validated |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-34-05 | Tampering | settings.tsx language picker | accept | Language values limited to LANGUAGES constant array ("en", "de"). Even if tampered, worst case is fallback to "en". |
+</threat_model>
+
+<verification>
+- `bun run build` succeeds
+- Language picker visible in settings page
+- Clicking a language option changes the UI language
+- Language preference persists across page reloads
+</verification>
+
+<success_criteria>
+- Language picker in settings with English and Deutsch options
+- Pill-toggle pattern matches weight unit and currency pickers
+- Language change persists and syncs with i18n
+- Browser auto-detection works for first visit
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/34-i18n-foundation/34-04-SUMMARY.md`
+</output>

.planning/phases/34-i18n-foundation/34-05-PLAN.md

@@ -0,0 +1,364 @@
+---
+phase: 34-i18n-foundation
+plan: 05
+type: execute
+wave: 3
+depends_on: [01, 02, 03, 04]
+files_modified:
+  - src/client/locales/de/common.json
+  - src/client/locales/de/collection.json
+  - src/client/locales/de/threads.json
+  - src/client/locales/de/setups.json
+  - src/client/locales/de/onboarding.json
+  - src/client/locales/de/settings.json
+  - src/client/lib/i18n.ts
+  - tests/i18n/locales.test.ts
+autonomous: true
+requirements: [D-13, D-14, D-15]
+
+must_haves:
+  truths:
+    - "German locale files exist at src/client/locales/de/ for all 6 namespaces"
+    - "Every key in en/*.json has a corresponding key in de/*.json"
+    - "German translations are natural German, not word-for-word translations"
+    - "i18n.ts loads both en and de resources"
+    - "Switching to de locale renders German text throughout the app"
+    - "A test verifies key parity between en and de locales"
+  artifacts:
+    - path: "src/client/locales/de/common.json"
+      provides: "German common namespace translations"
+      contains: "Speichern"
+    - path: "src/client/locales/de/settings.json"
+      provides: "German settings translations"
+      contains: "Gewichtseinheit"
+    - path: "src/client/lib/i18n.ts"
+      provides: "Updated i18n init with de resources"
+      contains: "deCommon"
+    - path: "tests/i18n/locales.test.ts"
+      provides: "Key parity test"
+      min_lines: 20
+  key_links:
+    - from: "src/client/lib/i18n.ts"
+      to: "src/client/locales/de/common.json"
+      via: "import deCommon"
+      pattern: "deCommon"
+---
+
+<objective>
+Create German translations for all namespaces and register them in the i18n configuration.
+
+Purpose: Ship the first additional language — German (de) alongside English (en), making the app fully bilingual.
+Output: Complete German translation files, i18n config updated, key parity test.
+</objective>
+
+<execution_context>
+@$HOME/.claude/get-shit-done/workflows/execute-plan.md
+@$HOME/.claude/get-shit-done/templates/summary.md
+</execution_context>
+
+<context>
+@.planning/PROJECT.md
+@.planning/ROADMAP.md
+@.planning/STATE.md
+@.planning/phases/34-i18n-foundation/34-CONTEXT.md
+@.planning/phases/34-i18n-foundation/34-RESEARCH.md
+
+<interfaces>
+English locale files (source of truth for key structure):
+- src/client/locales/en/common.json
+- src/client/locales/en/collection.json
+- src/client/locales/en/threads.json
+- src/client/locales/en/setups.json
+- src/client/locales/en/onboarding.json
+- src/client/locales/en/settings.json
+
+i18n.ts resources structure:
+```typescript
+resources: {
+  en: {
+    common: enCommon,
+    collection: enCollection,
+    // ...
+  },
+  // de needs to be added here
+},
+```
+</interfaces>
+</context>
+
+<tasks>
+
+<task type="auto">
+  <name>Task 1: Create German translation files for all namespaces</name>
+  <files>src/client/locales/de/common.json, src/client/locales/de/collection.json, src/client/locales/de/threads.json, src/client/locales/de/setups.json, src/client/locales/de/onboarding.json, src/client/locales/de/settings.json</files>
+  <read_first>src/client/locales/en/common.json, src/client/locales/en/collection.json, src/client/locales/en/threads.json, src/client/locales/en/setups.json, src/client/locales/en/onboarding.json, src/client/locales/en/settings.json</read_first>
+  <behavior>
+    - Each de/*.json has the exact same key structure as its en/*.json counterpart
+    - Values are natural German translations, not literal word-for-word
+    - German translations use formal "Sie" form (standard for apps)
+    - Common action buttons: Save→Speichern, Cancel→Abbrechen, Delete→Loeschen, Edit→Bearbeiten, Create→Erstellen, Close→Schliessen, Back→Zurueck, Search→Suchen
+    - Navigation: Home→Startseite, Collection→Sammlung, Setups→Setups (keep English), Discover→Entdecken, Settings→Einstellungen
+    - Interpolation variables ({{count}}, {{name}}) remain unchanged
+    - Pluralization keys (_one, _other) have German plural forms
+  </behavior>
+  <action>
+Create directory `src/client/locales/de/`.
+
+For EACH English locale file (`src/client/locales/en/*.json`):
+1. Read the file to get the exact key structure
+2. Create the corresponding `src/client/locales/de/*.json` with the same key structure
+3. Translate every value to natural German
+
+**Translation guidelines:**
+- Use formal "Sie" address form (standard for web apps)
+- Keep brand names and technical terms in English where German speakers would expect it (e.g., "Setup" stays "Setup", "Thread" can stay "Thread" or become "Recherche")
+- Weight units (g, oz, lb, kg) are universal — keep as-is
+- Currency symbols stay as-is
+- Interpolation placeholders like `{{count}}` or `{{name}}` must remain exactly as-is in the German text
+- Pluralization: German uses the same _one/_other pattern as English for most cases
+
+**Key German translations reference:**
+
+| English | German |
+|---------|--------|
+| Save | Speichern |
+| Cancel | Abbrechen |
+| Delete | Loeschen |
+| Edit | Bearbeiten |
+| Create | Erstellen |
+| Close | Schliessen |
+| Back | Zurueck |
+| Search | Suchen |
+| Confirm | Bestaetigen |
+| Loading... | Laden... |
+| Something went wrong | Etwas ist schiefgelaufen |
+| Sign in | Anmelden |
+| Sign out | Abmelden |
+| Settings | Einstellungen |
+| Collection | Sammlung |
+| Items | Gegenstaende |
+| Weight | Gewicht |
+| Price | Preis |
+| Name | Name |
+| Brand | Marke |
+| Model | Modell |
+| Notes | Notizen |
+| Category | Kategorie |
+| No items yet | Noch keine Gegenstaende |
+| Weight Unit | Gewichtseinheit |
+| Currency | Waehrung |
+| Language | Sprache |
+| Import / Export | Import / Export |
+| API Keys | API-Schluessel |
+
+**IMPORTANT:** Read each en/*.json file fully before translating. Every single key must have a German value. Do not leave any English strings in the de/*.json files.
+  </action>
+  <acceptance_criteria>
+    - src/client/locales/de/common.json exists and is valid JSON
+    - src/client/locales/de/collection.json exists and is valid JSON
+    - src/client/locales/de/threads.json exists and is valid JSON
+    - src/client/locales/de/setups.json exists and is valid JSON
+    - src/client/locales/de/onboarding.json exists and is valid JSON
+    - src/client/locales/de/settings.json exists and is valid JSON
+    - de/common.json "actions.save" value is "Speichern" (not "Save")
+    - de/common.json "nav.settings" value is "Einstellungen" (not "Settings")
+    - de/settings.json contains "Gewichtseinheit" for weight unit label
+    - All interpolation variables ({{count}}, {{name}}) preserved in German translations
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && for f in common collection threads setups onboarding settings; do node -e "JSON.parse(require('fs').readFileSync('src/client/locales/de/$f.json','utf8')); console.log('de/$f.json: valid')"; done</automated>
+  </verify>
+  <done>All 6 German translation files created with complete translations</done>
+</task>
+
+<task type="auto">
+  <name>Task 2: Register German locale in i18n configuration</name>
+  <files>src/client/lib/i18n.ts</files>
+  <read_first>src/client/lib/i18n.ts</read_first>
+  <behavior>
+    - i18n.ts imports all 6 de/*.json files
+    - resources object includes "de" key with all 6 namespaces
+    - supportedLngs is set to ["en", "de"] to prevent loading unsupported locales
+  </behavior>
+  <action>
+Update `src/client/lib/i18n.ts`:
+
+1. Add imports for all German locale files (after the English imports):
+```typescript
+import deCommon from "../locales/de/common.json";
+import deCollection from "../locales/de/collection.json";
+import deThreads from "../locales/de/threads.json";
+import deSetups from "../locales/de/setups.json";
+import deOnboarding from "../locales/de/onboarding.json";
+import deSettings from "../locales/de/settings.json";
+```
+
+2. Add `de` entry to the `resources` object:
+```typescript
+resources: {
+  en: {
+    common: enCommon,
+    collection: enCollection,
+    threads: enThreads,
+    setups: enSetups,
+    onboarding: enOnboarding,
+    settings: enSettings,
+  },
+  de: {
+    common: deCommon,
+    collection: deCollection,
+    threads: deThreads,
+    setups: deSetups,
+    onboarding: deOnboarding,
+    settings: deSettings,
+  },
+},
+```
+
+3. Add `supportedLngs: ["en", "de"]` to the init config (after `fallbackLng`). This prevents i18next from trying to load unsupported locales and forces fallback to "en" per D-12.
+  </action>
+  <acceptance_criteria>
+    - i18n.ts imports deCommon, deCollection, deThreads, deSetups, deOnboarding, deSettings
+    - i18n.ts resources object has "de" key with all 6 namespaces
+    - i18n.ts has supportedLngs: ["en", "de"]
+    - `bun run build` succeeds
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && grep -c "deCommon\|deCollection\|deThreads\|deSetups\|deOnboarding\|deSettings\|supportedLngs" src/client/lib/i18n.ts</automated>
+  </verify>
+  <done>i18n config loads both English and German resources</done>
+</task>
+
+<task type="auto" tdd="true">
+  <name>Task 3: Write key parity test between en and de locales</name>
+  <files>tests/i18n/locales.test.ts</files>
+  <read_first>src/client/locales/en/common.json, src/client/locales/de/common.json</read_first>
+  <behavior>
+    - Test reads all en/*.json and de/*.json files
+    - For each namespace, flattens keys to dot notation
+    - Asserts every en key exists in de
+    - Asserts every de key exists in en (no orphan keys)
+    - Asserts no de values are empty strings
+    - Test fails if a key is missing from either locale
+  </behavior>
+  <action>
+Create directory `tests/i18n/` if not exists.
+
+Create `tests/i18n/locales.test.ts`:
+
+```typescript
+import { describe, expect, test } from "bun:test";
+import { readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+
+const LOCALES_DIR = join(import.meta.dir, "../../src/client/locales");
+
+function flattenKeys(obj: Record<string, unknown>, prefix = ""): string[] {
+  const keys: string[] = [];
+  for (const [key, value] of Object.entries(obj)) {
+    const fullKey = prefix ? `${prefix}.${key}` : key;
+    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+      keys.push(...flattenKeys(value as Record<string, unknown>, fullKey));
+    } else {
+      keys.push(fullKey);
+    }
+  }
+  return keys.sort();
+}
+
+function loadLocale(locale: string): Record<string, Record<string, unknown>> {
+  const dir = join(LOCALES_DIR, locale);
+  const files = readdirSync(dir).filter((f) => f.endsWith(".json"));
+  const result: Record<string, Record<string, unknown>> = {};
+  for (const file of files) {
+    const ns = file.replace(".json", "");
+    result[ns] = JSON.parse(readFileSync(join(dir, file), "utf8"));
+  }
+  return result;
+}
+
+describe("locale key parity", () => {
+  const en = loadLocale("en");
+  const de = loadLocale("de");
+
+  test("en and de have the same namespaces", () => {
+    expect(Object.keys(en).sort()).toEqual(Object.keys(de).sort());
+  });
+
+  for (const ns of Object.keys(en)) {
+    test(`${ns}: every en key exists in de`, () => {
+      const enKeys = flattenKeys(en[ns]);
+      const deKeys = flattenKeys(de[ns]);
+      const missing = enKeys.filter((k) => !deKeys.includes(k));
+      expect(missing).toEqual([]);
+    });
+
+    test(`${ns}: every de key exists in en`, () => {
+      const enKeys = flattenKeys(en[ns]);
+      const deKeys = flattenKeys(de[ns]);
+      const orphan = deKeys.filter((k) => !enKeys.includes(k));
+      expect(orphan).toEqual([]);
+    });
+
+    test(`${ns}: no empty de values`, () => {
+      const deFlat = flattenKeys(de[ns]);
+      for (const key of deFlat) {
+        const value = key.split(".").reduce(
+          (obj, k) => (obj as Record<string, unknown>)?.[k],
+          de[ns] as unknown,
+        );
+        expect(typeof value === "string" && value.length > 0).toBe(true);
+      }
+    });
+  }
+});
+```
+
+This test automatically discovers all namespace files and checks key parity without hardcoding namespace names. When future languages are added, the test structure can be extended.
+  </action>
+  <acceptance_criteria>
+    - tests/i18n/locales.test.ts exists
+    - Test checks namespace parity between en and de
+    - Test checks key parity for each namespace (both directions)
+    - Test checks no empty strings in de translations
+    - `bun test tests/i18n/locales.test.ts` passes
+  </acceptance_criteria>
+  <verify>
+    <automated>cd /home/jlmak/Projects/jlmak/GearBox && bun test tests/i18n/locales.test.ts</automated>
+  </verify>
+  <done>Key parity test ensures en and de locales stay in sync</done>
+</task>
+
+</tasks>
+
+<threat_model>
+## Trust Boundaries
+
+| Boundary | Description |
+|----------|-------------|
+| locale JSON→i18n | Static bundled files — trusted, no runtime injection vector |
+
+## STRIDE Threat Register
+
+| Threat ID | Category | Component | Disposition | Mitigation Plan |
+|-----------|----------|-----------|-------------|-----------------|
+| T-34-06 | Spoofing | de locale files | accept | German translations are AI-generated per D-14. No security implication — worst case is awkward German. Users correct organically. |
+</threat_model>
+
+<verification>
+- All 6 de/*.json files are valid JSON
+- `bun test tests/i18n/locales.test.ts` passes (key parity)
+- `bun run build` succeeds
+- Switching to "de" in settings renders German text
+</verification>
+
+<success_criteria>
+- Complete German translations for all 6 namespaces
+- i18n config loads both en and de resources
+- Key parity test prevents translation drift
+- Build passes with both locales
+</success_criteria>
+
+<output>
+After completion, create `.planning/phases/34-i18n-foundation/34-05-SUMMARY.md`
+</output>

.planning/phases/34-i18n-foundation/34-CONTEXT.md

@@ -0,0 +1,115 @@
+# Phase 34: i18n Foundation - Context
+
+**Gathered:** 2026-04-13
+**Status:** Ready for planning
+
+<domain>
+## Phase Boundary
+
+Add a translation framework to GearBox with string extraction, locale-aware formatting, and ship English + German. UI chrome and system content are translated. Catalog data and user-generated content remain untranslated. Language selection is independent from market/currency (Phase 33) but both auto-detected from browser.
+
+</domain>
+
+<decisions>
+## Implementation Decisions
+
+### Translation Scope & Boundaries
+- **D-01:** Translate UI chrome: buttons, labels, headings, navigation items, empty states, error messages, toast notifications, modal titles/descriptions, placeholder text
+- **D-02:** Translate system content: default category names (e.g., "Uncategorized"), onboarding flow text, MCP tool descriptions, email templates if any
+- **D-03:** Do NOT translate: catalog item names/descriptions, user-generated content (item names, notes, setup names, thread titles), category names created by users
+- **D-04:** Locale-aware formatting integrates with the existing `useFormatters()` hook — number formatting, date formatting, and pluralization handled by the i18n framework, weight/price formatting continues through existing formatters
+
+### Library & Architecture
+- **D-05:** Claude's discretion on library choice — pick between react-i18next and Lingui based on best fit with React 19, Vite, Bun, Hono stack. Key criteria: hook-based API, lazy loading per locale, compile-time or runtime extraction, TypeScript support
+- **D-06:** Translation files stored as JSON in the repo: `src/client/locales/en.json`, `src/client/locales/de.json`. Checked into git. Switching to an external translation service (Crowdin/Lokalise) later is a CI/sync change, not a code change
+- **D-07:** Translations loaded client-side — the React app loads the appropriate locale JSON. Server-side strings (API error messages, MCP descriptions) use a simple server-side translation utility
+- **D-08:** Namespace support for organizing strings by feature area (e.g., `common`, `collection`, `threads`, `setups`, `onboarding`, `settings`) to keep files manageable as string count grows
+
+### Language Selection UX
+- **D-09:** Language and market/currency are independent settings. A German expat in the UK can have GBP prices but German UI
+- **D-10:** Language auto-detected from browser locale on first visit (navigator.language). User can override in settings
+- **D-11:** Language picker in settings page — alongside but separate from the market/currency picker from Phase 33
+- **D-12:** If browser locale has no matching translation (e.g., `ja`), fall back to English
+
+### First Additional Language
+- **D-13:** German (de) ships alongside English (en) as the first additional language. Primary target market is EU/DE
+- **D-14:** German translations AI-generated by Claude during implementation. No formal review step — user catches and fixes issues organically during app usage
+- **D-15:** Translation quality approach for future languages: same AI-generated strategy. Professional/community translation deferred until there's a real user base requesting specific languages
+
+### Claude's Discretion
+- Library choice between react-i18next and Lingui (evaluate DX, bundle size, extraction tooling, React 19 compatibility)
+- String key naming convention (flat vs. nested, dot notation style)
+- How to handle dynamic content interpolation patterns
+- Whether to extract strings from existing components in one pass or incrementally
+
+</decisions>
+
+<canonical_refs>
+## Canonical References
+
+**Downstream agents MUST read these before planning or implementing.**
+
+No external specs — requirements fully captured in decisions above.
+
+### Existing Implementation (to integrate with)
+- `src/client/hooks/useFormatters.ts` — Central formatting hook for weight + price. i18n number/date formatting should integrate here
+- `src/client/lib/formatters.ts` — `formatWeight()` and `formatPrice()` functions. Locale-aware formatting may need to wrap or replace these
+- `src/client/hooks/useCurrency.ts` — Currency/market hook. Language selection is separate but both auto-detect from browser
+- `src/client/routes/settings.tsx` — Settings page where language picker will be added
+- `src/client/routes/__root.tsx` — Root layout where i18n provider wraps the app
+- `src/client/main.tsx` — App entry point for i18n initialization
+- `src/server/mcp/` — MCP tool descriptions need server-side translation
+- `src/client/components/onboarding/` — Onboarding flow has significant translatable text
+
+### Phase 33 Integration
+- `src/client/hooks/useCurrency.ts` — Market auto-detection logic from Phase 33. Language auto-detection should follow the same pattern but remain independent
+
+</canonical_refs>
+
+<code_context>
+## Existing Code Insights
+
+### Reusable Assets
+- `useFormatters()` hook: Already composites weight + price formatting. Extend to include locale-aware number/date formatting
+- `useSetting()` hook: Settings storage pattern — language preference fits here
+- Settings page: Existing pill-toggle pattern (used for weight units, currency) — reuse for language picker
+
+### Established Patterns
+- Hooks for user preferences (`useWeightUnit`, `useCurrency`) — `useLanguage` follows the same pattern
+- Settings stored in DB via settings table, read via `useSetting()` hook
+- Component structure: presentational components in `components/`, route components in `routes/`
+
+### Integration Points
+- `src/client/main.tsx`: Initialize i18n provider
+- `src/client/routes/__root.tsx`: Wrap app in i18n context provider
+- `src/client/routes/settings.tsx`: Add language picker
+- Every component with hardcoded English strings: needs `t()` calls (bulk extraction task)
+- `src/server/index.ts`: Server-side translation utility initialization for API errors and MCP descriptions
+
+### Scale of String Extraction
+- Estimated 100-200 translatable strings across the app (buttons, labels, headings, empty states, error messages, onboarding flow)
+- Onboarding flow is the most string-heavy component
+
+</code_context>
+
+<specifics>
+## Specific Ideas
+
+- Language picker uses the same pill-toggle pattern as weight units and currency in settings
+- Auto-detection: `navigator.language` → match to available locales → fallback to `en`
+- String extraction can be done incrementally — doesn't need to be all-at-once
+- German translations generated alongside English during implementation, not as a separate post-extraction step
+
+</specifics>
+
+<deferred>
+## Deferred Ideas
+
+None — discussion stayed within phase scope.
+
+</deferred>
+
+---
+
+*Phase: 34-i18n-foundation*
+*Context gathered: 2026-04-13*

.planning/phases/34-i18n-foundation/34-DISCUSSION-LOG.md

@@ -0,0 +1,92 @@
+# Phase 34: i18n Foundation - Discussion Log
+
+> **Audit trail only.** Do not use as input to planning, research, or execution agents.
+> Decisions are captured in CONTEXT.md — this log preserves the alternatives considered.
+
+**Date:** 2026-04-13
+**Phase:** 34-i18n Foundation
+**Areas discussed:** Translation scope & boundaries, Library & architecture, Language selection UX, First additional language
+
+---
+
+## Translation Scope & Boundaries
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| UI chrome only | Buttons, labels, headings, empty states, errors, navigation | |
+| UI chrome + system content | UI chrome plus default categories, onboarding text, MCP descriptions | ✓ |
+| Everything including catalog | UI + system + catalog item names/descriptions per locale | |
+
+**User's choice:** UI chrome + system content
+**Notes:** Catalog data translation deferred — too much content to maintain translations for.
+
+---
+
+## Library & Architecture
+
+### Library choice
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| react-i18next | Most popular, hook-based, JSON files, namespaces, lazy loading | |
+| Lingui | Compile-time extraction, smaller runtime, macro-based | |
+| You decide | Claude picks based on stack fit | ✓ |
+
+**User's choice:** Claude's discretion
+
+### Translation storage
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| JSON files in repo | en.json, de.json checked into git. Simple, reviewable in PRs | ✓ |
+| External translation service | Crowdin/Lokalise with web UI for translators | |
+| You decide | Claude picks | |
+
+**User's choice:** JSON in repo. User asked whether this is easy to switch later — confirmed it is. Translation keys are the same regardless of storage; switching to external service is a CI/sync change, not a code rewrite.
+
+---
+
+## Language Selection UX
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Separate setting | Language and currency/market are independent | |
+| Tied to market | EUR/DE = German, GBP/UK = English | |
+| Auto-detect with override | Browser locale auto-detect, independent from market, overridable | ✓ |
+
+**User's choice:** Auto-detect with override, independent from market/currency.
+
+---
+
+## First Additional Language
+
+### Language choice
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| German (de) | Primary target market, user speaks it natively | ✓ |
+| French (fr) | Tests different grammar family | |
+| Both German + French | Stress-tests the system | |
+
+**User's choice:** German. User noted they can't validate French ("aint speaking french, can only send ai agents to test").
+
+### Translation production
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Manual translation | User writes German strings | |
+| AI-generated, user reviews | Claude generates, user does formal review pass | |
+| AI-generated, fix organically | Claude generates, user catches issues during normal app usage | ✓ |
+
+**User's choice:** AI-generated, no dedicated review — fix issues as they're noticed.
+
+## Claude's Discretion
+
+- Library choice (react-i18next vs. Lingui)
+- String key naming convention
+- Dynamic content interpolation patterns
+- Extraction strategy (bulk vs. incremental)
+
+## Deferred Ideas
+
+None — discussion stayed within phase scope.

.planning/phases/34-i18n-foundation/34-RESEARCH.md

@@ -0,0 +1,281 @@
+# Phase 34: i18n Foundation - Research
+
+**Researched:** 2026-04-13
+**Status:** Complete
+
+## Library Evaluation
+
+### react-i18next vs Lingui
+
+| Criterion | react-i18next | Lingui |
+|-----------|--------------|--------|
+| React 19 support | Yes (v15+) | Yes (v5+) |
+| Hook-based API | `useTranslation()` | `useLingui()` |
+| Lazy loading | Built-in (`react-i18next/icu`) backend, dynamic imports | Catalog-based lazy loading via `@lingui/loader` |
+| TypeScript support | Strong with `i18next` typed resources | Strong with compiled catalogs |
+| Bundle size | ~10kb (i18next core + react-i18next) | ~5kb (runtime only) |
+| Vite plugin | `i18next-resources-for-ts` or manual | `@lingui/vite-plugin` |
+| Extraction tooling | `i18next-parser` (CLI) | `@lingui/cli extract` (built-in) |
+| JSON file format | Native JSON key-value | PO files or JSON catalogs |
+| Bun/Hono server-side | `i18next` works standalone (no React dependency) | `@lingui/core` works standalone |
+| Community/ecosystem | Larger ecosystem, more plugins | Growing, more opinionated |
+| Namespace support | Built-in first-class | Via message IDs with prefixes |
+| Interpolation | `{{name}}` syntax | `{name}` syntax with ICU |
+
+**Recommendation: react-i18next**
+
+Reasons:
+1. **Namespace support is first-class** — CONTEXT.md decision D-08 requires namespaces by feature area. react-i18next has this built-in; Lingui requires manual ID prefixing.
+2. **JSON translation files** — Decision D-06 specifies JSON files in `src/client/locales/`. react-i18next uses plain JSON natively. Lingui prefers PO files or its own catalog format.
+3. **Server-side reuse** — `i18next` core (no React) can be used directly in Hono routes and MCP tool descriptions. Same translation files, same API.
+4. **Larger ecosystem** — More documentation, Stack Overflow answers, and community plugins for future needs (Crowdin/Lokalise integration mentioned in D-06).
+5. **Lazy loading** — `i18next-http-backend` or dynamic imports work cleanly with Vite code splitting.
+
+### Required Packages
+
+```
+i18next                    # Core translation engine
+react-i18next              # React bindings (useTranslation hook)
+i18next-browser-languagedetector  # Auto-detect browser locale (D-10)
+```
+
+No additional Vite plugins needed — JSON imports work natively.
+
+## Architecture Design
+
+### Client-Side Setup
+
+```
+src/client/
+├── locales/
+│   ├── en/
+│   │   ├── common.json       # Shared: buttons, labels, navigation
+│   │   ├── collection.json   # Collection page strings
+│   │   ├── threads.json      # Research threads strings
+│   │   ├── setups.json       # Setups strings
+│   │   ├── onboarding.json   # Onboarding flow strings
+│   │   └── settings.json     # Settings page strings
+│   └── de/
+│       ├── common.json
+│       ├── collection.json
+│       ├── threads.json
+│       ├── setups.json
+│       ├── onboarding.json
+│       └── settings.json
+├── lib/
+│   └── i18n.ts              # i18next initialization
+```
+
+**Namespace strategy (D-08):**
+- `common` — buttons ("Save", "Cancel", "Delete"), nav items, shared labels, error messages, empty states
+- `collection` — collection page, item forms, item cards
+- `threads` — thread list, thread detail, candidate forms
+- `setups` — setup list, setup detail, impact preview
+- `onboarding` — welcome, hobby picker, item browser, review, done screens
+- `settings` — settings page labels, API keys section, import/export
+
+### i18n Initialization (`src/client/lib/i18n.ts`)
+
+```typescript
+import i18n from "i18next";
+import { initReactI18next } from "react-i18next";
+import LanguageDetector from "i18next-browser-languagedetector";
+
+// Eager-load both locales (small app, 2 languages)
+import enCommon from "../locales/en/common.json";
+import enCollection from "../locales/en/collection.json";
+import enThreads from "../locales/en/threads.json";
+import enSetups from "../locales/en/setups.json";
+import enOnboarding from "../locales/en/onboarding.json";
+import enSettings from "../locales/en/settings.json";
+
+import deCommon from "../locales/de/common.json";
+import deCollection from "../locales/de/collection.json";
+import deThreads from "../locales/de/threads.json";
+import deSetups from "../locales/de/setups.json";
+import deOnboarding from "../locales/de/onboarding.json";
+import deSettings from "../locales/de/settings.json";
+
+i18n
+  .use(LanguageDetector)
+  .use(initReactI18next)
+  .init({
+    resources: {
+      en: {
+        common: enCommon,
+        collection: enCollection,
+        threads: enThreads,
+        setups: enSetups,
+        onboarding: enOnboarding,
+        settings: enSettings,
+      },
+      de: {
+        common: deCommon,
+        collection: deCollection,
+        threads: deThreads,
+        setups: deSetups,
+        onboarding: deOnboarding,
+        settings: deSettings,
+      },
+    },
+    fallbackLng: "en",
+    defaultNS: "common",
+    interpolation: {
+      escapeValue: false, // React handles XSS
+    },
+    detection: {
+      order: ["localStorage", "navigator"],
+      lookupLocalStorage: "gearbox-language",
+      caches: ["localStorage"],
+    },
+  });
+
+export default i18n;
+```
+
+**Note on lazy loading:** With only 2 languages and ~200 strings, eager loading all namespaces is simpler and avoids loading spinners. Total JSON payload is <20KB gzipped. Lazy loading can be added later when more languages are added.
+
+### Integration with `useFormatters()`
+
+Decision D-04 specifies i18n integrates with the existing formatters hook. The formatters currently use manual string concatenation. With i18n, number and date formatting should use `Intl.NumberFormat` and `Intl.DateTimeFormat` for locale-aware output.
+
+**Approach:** Extend `useFormatters()` to accept locale from i18n context and pass it to `formatWeight()` and `formatPrice()`. The format functions gain a `locale` parameter:
+
+```typescript
+// formatPrice now uses Intl.NumberFormat for locale-aware number display
+export function formatPrice(cents: number | null, currency: Currency, locale: string): string {
+  if (cents == null) return "--";
+  return new Intl.NumberFormat(locale, {
+    style: "currency",
+    currency,
+    minimumFractionDigits: currency === "JPY" ? 0 : 2,
+  }).format(cents / 100);
+}
+```
+
+This replaces the manual symbol lookup with `Intl.NumberFormat` which handles symbol placement, decimal separators, and grouping per locale (e.g., German: `1.234,56 €` vs English: `$1,234.56`).
+
+### Language Setting Storage
+
+Following the `useWeightUnit()` and `useCurrency()` pattern:
+
+```typescript
+// src/client/hooks/useLanguage.ts
+export function useLanguage(): string {
+  const { data } = useSetting("language");
+  return data && VALID_LANGUAGES.includes(data) ? data : "en";
+}
+```
+
+**Key difference from weight/currency:** Language changes need to call `i18n.changeLanguage()` in addition to persisting via `useSetting()`. A `useEffect` in the root layout (or the `useLanguage` hook) syncs the i18n instance when the setting changes.
+
+### Server-Side Translation
+
+MCP tool descriptions and API error messages need server-side translation. Since Hono runs on Bun (not browser), use `i18next` core directly:
+
+```typescript
+// src/server/lib/i18n.ts
+import i18next from "i18next";
+import en from "../../client/locales/en/common.json";
+import de from "../../client/locales/de/common.json";
+
+const serverI18n = i18next.createInstance();
+serverI18n.init({
+  lng: "en", // Default server language
+  resources: { en: { common: en }, de: { common: de } },
+  defaultNS: "common",
+});
+
+export function t(key: string, lng?: string): string {
+  return serverI18n.t(key, { lng });
+}
+```
+
+**MCP tool descriptions:** These are registered once at server start and consumed by AI clients. They should remain in English — AI models work best with English tool descriptions. Server-side i18n applies to API error messages returned to the browser, not MCP tool descriptions.
+
+### String Key Convention
+
+**Nested keys with dot notation:**
+
+```json
+{
+  "nav": {
+    "collection": "Collection",
+    "setups": "Setups",
+    "discover": "Discover",
+    "settings": "Settings"
+  },
+  "actions": {
+    "save": "Save",
+    "cancel": "Cancel",
+    "delete": "Delete",
+    "edit": "Edit",
+    "create": "Create"
+  },
+  "empty": {
+    "noItems": "No items yet",
+    "noThreads": "No research threads yet"
+  }
+}
+```
+
+Access pattern: `t("nav.collection")`, `t("actions.save")`.
+
+### Language Picker UX
+
+Reuse the pill-toggle pattern from weight unit and currency in settings:
+
+```tsx
+const LANGUAGES = [
+  { value: "en", label: "English" },
+  { value: "de", label: "Deutsch" },
+];
+```
+
+Place in the settings page above weight unit, since language is the most fundamental preference.
+
+### String Extraction Strategy
+
+Given ~200 strings across ~50 components, extraction should be done systematically by feature area matching the namespace structure:
+
+1. **Common** — TopNav, BottomTabBar, FabMenu, ConfirmDialog, AuthPromptModal, empty states
+2. **Collection** — CollectionView, ItemCard, ItemForm, CategoryPicker, CategoryHeader, WeightSummaryCard
+3. **Threads** — ThreadCard, ThreadTabs, CandidateCard, CandidateForm, ComparisonTable, CreateThreadModal
+4. **Setups** — SetupsView, SetupCard, SetupImpactSelector, ShareModal
+5. **Onboarding** — OnboardingWelcome, OnboardingHobbyPicker, OnboardingItemBrowser, OnboardingReview, OnboardingDone
+6. **Settings** — SettingsPage (weight, currency, language, API keys, import/export)
+
+## Validation Architecture
+
+### Test Strategy
+
+1. **Unit tests** — i18n initialization loads both locales without error
+2. **Unit tests** — `useLanguage()` hook returns correct language from settings
+3. **Unit tests** — `formatPrice()` with locale produces correct output for en and de
+4. **Unit tests** — `formatWeight()` with locale produces correct output for en and de
+5. **Integration test** — Language change via settings API persists and takes effect
+6. **E2E test** — Switch language in settings, verify UI text changes to German
+
+### Completeness Checks
+
+- Every `en/*.json` key has a corresponding `de/*.json` key (no missing translations)
+- No hardcoded English strings remain in components that have been extracted
+- `i18n.ts` registers all namespaces for both languages
+- Language picker appears in settings and persists selection
+
+## Risk Assessment
+
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| React 19 compatibility with react-i18next | Medium | react-i18next v15+ supports React 19. Pin compatible version. |
+| Bundle size increase | Low | i18next + react-i18next is ~10KB gzipped. JSON files add <10KB per language. |
+| String extraction misses some strings | Low | Incremental approach — extract by namespace area, verify each area. |
+| German translation quality | Low | AI-generated is acceptable per D-14. User corrects organically. |
+| Formatter locale breaking existing tests | Medium | Update test helpers to pass locale. Existing tests keep "en" default. |
+
+## Dependencies
+
+- **Phase 33 (Currency System):** Language detection should follow the same browser auto-detection pattern. The `useCurrency` hook pattern is the model for `useLanguage`. Phase 33 may add market auto-detection; language auto-detection is independent but similar.
+- **No schema changes needed:** Language preference stored in existing `settings` table via `useSetting("language")`.
+
+## RESEARCH COMPLETE

.planning/phases/34-i18n-foundation/34-VALIDATION.md

@@ -0,0 +1,79 @@
+---
+phase: 34
+slug: i18n-foundation
+status: draft
+nyquist_compliant: false
+wave_0_complete: false
+created: 2026-04-13
+---
+
+# Phase 34 — Validation Strategy
+
+> Per-phase validation contract for feedback sampling during execution.
+
+---
+
+## Test Infrastructure
+
+| Property | Value |
+|----------|-------|
+| **Framework** | Bun test runner + Playwright |
+| **Config file** | `bunfig.toml` / `playwright.config.ts` |
+| **Quick run command** | `bun test` |
+| **Full suite command** | `bun test && bun run test:e2e` |
+| **Estimated runtime** | ~15 seconds (unit) + ~60 seconds (e2e) |
+
+---
+
+## Sampling Rate
+
+- **After every task commit:** Run `bun test`
+- **After every plan wave:** Run `bun test && bun run build`
+- **Before `/gsd-verify-work`:** Full suite must be green
+- **Max feedback latency:** 15 seconds
+
+---
+
+## Per-Task Verification Map
+
+| Task ID | Plan | Wave | Requirement | Threat Ref | Secure Behavior | Test Type | Automated Command | File Exists | Status |
+|---------|------|------|-------------|------------|-----------------|-----------|-------------------|-------------|--------|
+| 34-01-01 | 01 | 1 | D-05 | — | N/A | unit | `bun test tests/i18n/init.test.ts` | ❌ W0 | ⬜ pending |
+| 34-01-02 | 01 | 1 | D-06 | — | N/A | unit | `bun test tests/i18n/locales.test.ts` | ❌ W0 | ⬜ pending |
+| 34-02-01 | 02 | 1 | D-01 | — | N/A | unit | `bun test` | ✅ | ⬜ pending |
+| 34-03-01 | 03 | 2 | D-04 | — | N/A | unit | `bun test tests/i18n/formatters.test.ts` | ❌ W0 | ⬜ pending |
+| 34-04-01 | 04 | 2 | D-09, D-10, D-11 | — | N/A | unit | `bun test tests/i18n/language-hook.test.ts` | ❌ W0 | ⬜ pending |
+| 34-05-01 | 05 | 3 | D-13, D-14 | — | N/A | manual | Visual check: German UI text | N/A | ⬜ pending |
+
+*Status: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky*
+
+---
+
+## Wave 0 Requirements
+
+- [ ] `tests/i18n/init.test.ts` — i18n initialization loads both locales
+- [ ] `tests/i18n/locales.test.ts` — all en keys have corresponding de keys
+- [ ] `tests/i18n/formatters.test.ts` — locale-aware formatting produces correct output
+- [ ] `tests/i18n/language-hook.test.ts` — language hook returns correct value from settings
+
+---
+
+## Manual-Only Verifications
+
+| Behavior | Requirement | Why Manual | Test Instructions |
+|----------|-------------|------------|-------------------|
+| German UI text renders correctly | D-13 | Visual quality of AI-generated translations | Switch to German in settings, navigate all pages, verify text is natural German |
+| Language picker pill-toggle UX | D-11 | Visual layout consistency with weight/currency toggles | Open settings, verify language picker matches existing toggle patterns |
+
+---
+
+## Validation Sign-Off
+
+- [ ] All tasks have `<automated>` verify or Wave 0 dependencies
+- [ ] Sampling continuity: no 3 consecutive tasks without automated verify
+- [ ] Wave 0 covers all MISSING references
+- [ ] No watch-mode flags
+- [ ] Feedback latency < 15s
+- [ ] `nyquist_compliant: true` set in frontmatter
+
+**Approval:** pending

bun.lock

@@ -17,11 +17,14 @@
         "drizzle-orm": "^0.45.1",
         "framer-motion": "^12.38.0",
         "hono": "^4.12.8",
+        "i18next": "^26.0.4",
+        "i18next-browser-languagedetector": "^8.2.1",
         "lucide-react": "^0.577.0",
         "postgres": "^3.4.9",
         "react": "^19.2.4",
         "react-dom": "^19.2.4",
         "react-easy-crop": "^5.5.7",
+        "react-i18next": "^17.0.2",
         "recharts": "^3.8.0",
         "sharp": "^0.34.5",
         "sonner": "^2.0.7",
@@ -166,6 +169,8 @@
 
     "@babel/plugin-syntax-typescript": ["@babel/plugin-syntax-typescript@7.28.6", "", { "dependencies": { "@babel/helper-plugin-utils": "^7.28.6" }, "peerDependencies": { "@babel/core": "^7.0.0-0" } }, "sha512-+nDNmQye7nlnuuHDboPbGm00Vqg3oO8niRRL27/4LYHUsHYh0zJ1xWOz0uRwNFmM1Avzk8wZbc6rdiYhomzv/A=="],
 
+    "@babel/runtime": ["@babel/runtime@7.29.2", "", {}, "sha512-JiDShH45zKHWyGe4ZNVRrCjBz8Nh9TMmZG1kh4QTK8hCBTWBi8Da+i7s1fJw7/lYpM4ccepSNfqzZ/QvABBi5g=="],
+
     "@babel/template": ["@babel/template@7.28.6", "", { "dependencies": { "@babel/code-frame": "^7.28.6", "@babel/parser": "^7.28.6", "@babel/types": "^7.28.6" } }, "sha512-YA6Ma2KsCdGb+WC6UpBVFJGXL58MDA6oyONbjyF/+5sBgxY/dwkhLogbMT2GXXyU84/IhRw/2D1Os1B/giz+BQ=="],
 
     "@babel/traverse": ["@babel/traverse@7.29.0", "", { "dependencies": { "@babel/code-frame": "^7.29.0", "@babel/generator": "^7.29.0", "@babel/helper-globals": "^7.28.0", "@babel/parser": "^7.29.0", "@babel/template": "^7.28.6", "@babel/types": "^7.29.0", "debug": "^4.3.1" } }, "sha512-4HPiQr0X7+waHfyXPZpWPfWL/J7dcN1mx9gL6WdQVMbPnF3+ZhSMs8tCxN7oHddJE9fhNE7+lxdnlyemKfJRuA=="],
@@ -794,8 +799,14 @@
 
     "hono": ["hono@4.12.8", "", {}, "sha512-VJCEvtrezO1IAR+kqEYnxUOoStaQPGrCmX3j4wDTNOcD1uRPFpGlwQUIW8niPuvHXaTUxeOUl5MMDGrl+tmO9A=="],
 
+    "html-parse-stringify": ["html-parse-stringify@3.0.1", "", { "dependencies": { "void-elements": "3.1.0" } }, "sha512-KknJ50kTInJ7qIScF3jeaFRpMpE8/lfiTdzf/twXyPBLAGrLRTmkz3AdTnKeh40X8k9L2fdYwEp/42WGXIRGcg=="],
+
     "http-errors": ["http-errors@2.0.1", "", { "dependencies": { "depd": "~2.0.0", "inherits": "~2.0.4", "setprototypeof": "~1.2.0", "statuses": "~2.0.2", "toidentifier": "~1.0.1" } }, "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ=="],
 
+    "i18next": ["i18next@26.0.4", "", { "dependencies": { "@babel/runtime": "^7.29.2" }, "peerDependencies": { "typescript": "^5 || ^6" }, "optionalPeers": ["typescript"] }, "sha512-gXF7U9bfioXPLv7mw8Qt2nfO7vij5MyINvPgVv99pX3fL1Y01pw2mKBFrlYpRxRCl2wz3ISenj6VsMJT2isfuA=="],
+
+    "i18next-browser-languagedetector": ["i18next-browser-languagedetector@8.2.1", "", { "dependencies": { "@babel/runtime": "^7.23.2" } }, "sha512-bZg8+4bdmaOiApD7N7BPT9W8MLZG+nPTOFlLiJiT8uzKXFjhxw4v2ierCXOwB5sFDMtuA5G4kgYZ0AznZxQ/cw=="],
+
     "iconv-lite": ["iconv-lite@0.7.2", "", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3.0.0" } }, "sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw=="],
 
     "ieee754": ["ieee754@1.2.1", "", {}, "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA=="],
@@ -964,6 +975,8 @@
 
     "react-easy-crop": ["react-easy-crop@5.5.7", "", { "dependencies": { "normalize-wheel": "^1.0.1", "tslib": "^2.0.1" }, "peerDependencies": { "react": ">=16.4.0", "react-dom": ">=16.4.0" } }, "sha512-kYo4NtMeXFQB7h1U+h5yhUkE46WQbQdq7if54uDlbMdZHdRgNehfvaFrXnFw5NR1PNoUOJIfTwLnWmEx/MaZnA=="],
 
+    "react-i18next": ["react-i18next@17.0.2", "", { "dependencies": { "@babel/runtime": "^7.29.2", "html-parse-stringify": "^3.0.1", "use-sync-external-store": "^1.6.0" }, "peerDependencies": { "i18next": ">= 26.0.1", "react": ">= 16.8.0", "typescript": "^5 || ^6" }, "optionalPeers": ["typescript"] }, "sha512-shBftH2vaTWK2Bsp7FiL+cevx3xFJlvFxmsDFQSrJc+6twHkP0tv/bGa01VVWzpreUVVwU+3Hev5iFqRg65RwA=="],
+
     "react-is": ["react-is@19.2.4", "", {}, "sha512-W+EWGn2v0ApPKgKKCy/7s7WHXkboGcsrXE+2joLyVxkbyVQfO3MUEaUQDHoSmb8TFFrSKYa9mw64WZHNHSDzYA=="],
 
     "react-redux": ["react-redux@9.2.0", "", { "dependencies": { "@types/use-sync-external-store": "^0.0.6", "use-sync-external-store": "^1.4.0" }, "peerDependencies": { "@types/react": "^18.2.25 || ^19", "react": "^18.0 || ^19", "redux": "^5.0.0" }, "optionalPeers": ["@types/react", "redux"] }, "sha512-ROY9fvHhwOD9ySfrF0wmvu//bKCQ6AeZZq1nJNtbDC+kk5DuSuNX/n6YWYF/SYy7bSba4D4FSz8DJeKY/S/r+g=="],
@@ -1102,6 +1115,8 @@
 
     "vite": ["vite@8.0.0", "", { "dependencies": { "@oxc-project/runtime": "0.115.0", "lightningcss": "^1.32.0", "picomatch": "^4.0.3", "postcss": "^8.5.8", "rolldown": "1.0.0-rc.9", "tinyglobby": "^0.2.15" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "peerDependencies": { "@types/node": "^20.19.0 || >=22.12.0", "@vitejs/devtools": "^0.0.0-alpha.31", "esbuild": "^0.27.0", "jiti": ">=1.21.0", "less": "^4.0.0", "sass": "^1.70.0", "sass-embedded": "^1.70.0", "stylus": ">=0.54.8", "sugarss": "^5.0.0", "terser": "^5.16.0", "tsx": "^4.8.1", "yaml": "^2.4.2" }, "optionalPeers": ["@types/node", "@vitejs/devtools", "esbuild", "jiti", "less", "sass", "sass-embedded", "stylus", "sugarss", "terser", "tsx", "yaml"], "bin": { "vite": "bin/vite.js" } }, "sha512-fPGaRNj9Zytaf8LEiBhY7Z6ijnFKdzU/+mL8EFBaKr7Vw1/FWcTBAMW0wLPJAGMPX38ZPVCVgLceWiEqeoqL2Q=="],
 
+    "void-elements": ["void-elements@3.1.0", "", {}, "sha512-Dhxzh5HZuiHQhbvTW9AMetFfBHDMYpo23Uo9btPXgdYP+3T5S+p+jgNy7spra+veYhBP2dCSgxR/i2Y02h5/6w=="],
+
     "webpack-virtual-modules": ["webpack-virtual-modules@0.6.2", "", {}, "sha512-66/V2i5hQanC51vBQKPH4aI8NMAcBW59FVBs+rC7eGHupMyfn34q7rZIE+ETlJ+XTevqfUhVVBgSUNSW2flEUQ=="],
 
     "which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],

drizzle-pg/0005_true_green_goblin.sql

@@ -0,0 +1,17 @@
+CREATE TABLE "shares" (
+	"id" serial PRIMARY KEY NOT NULL,
+	"setup_id" integer NOT NULL,
+	"token" text NOT NULL,
+	"permission" text DEFAULT 'read' NOT NULL,
+	"expires_at" timestamp,
+	"user_id" integer,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	"revoked_at" timestamp,
+	CONSTRAINT "shares_token_unique" UNIQUE("token")
+);
+--> statement-breakpoint
+ALTER TABLE "setups" ADD COLUMN "visibility" text DEFAULT 'private' NOT NULL;--> statement-breakpoint
+UPDATE "setups" SET "visibility" = 'public' WHERE "is_public" = true;--> statement-breakpoint
+ALTER TABLE "shares" ADD CONSTRAINT "shares_setup_id_setups_id_fk" FOREIGN KEY ("setup_id") REFERENCES "public"."setups"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "shares" ADD CONSTRAINT "shares_user_id_users_id_fk" FOREIGN KEY ("user_id") REFERENCES "public"."users"("id") ON DELETE no action ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "setups" DROP COLUMN "is_public";

drizzle-pg/0006_remarkable_susan_delgado.sql

@@ -0,0 +1,31 @@
+CREATE TABLE "community_prices" (
+	"id" serial PRIMARY KEY NOT NULL,
+	"global_item_id" integer NOT NULL,
+	"user_id" integer NOT NULL,
+	"market" text NOT NULL,
+	"currency" text NOT NULL,
+	"price_cents" integer NOT NULL,
+	"price_date" timestamp,
+	"source_type" text NOT NULL,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	CONSTRAINT "community_prices_global_item_id_user_id_source_type_unique" UNIQUE("global_item_id","user_id","source_type")
+);
+--> statement-breakpoint
+CREATE TABLE "market_prices" (
+	"id" serial PRIMARY KEY NOT NULL,
+	"global_item_id" integer NOT NULL,
+	"market" text NOT NULL,
+	"currency" text NOT NULL,
+	"price_cents" integer NOT NULL,
+	"source" text,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	CONSTRAINT "market_prices_global_item_id_market_currency_unique" UNIQUE("global_item_id","market","currency")
+);
+--> statement-breakpoint
+ALTER TABLE "items" ADD COLUMN "price_currency" text DEFAULT 'EUR';--> statement-breakpoint
+ALTER TABLE "thread_candidates" ADD COLUMN "found_price_cents" integer;--> statement-breakpoint
+ALTER TABLE "thread_candidates" ADD COLUMN "found_price_currency" text;--> statement-breakpoint
+ALTER TABLE "thread_candidates" ADD COLUMN "found_price_date" timestamp;--> statement-breakpoint
+ALTER TABLE "community_prices" ADD CONSTRAINT "community_prices_global_item_id_global_items_id_fk" FOREIGN KEY ("global_item_id") REFERENCES "public"."global_items"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "community_prices" ADD CONSTRAINT "community_prices_user_id_users_id_fk" FOREIGN KEY ("user_id") REFERENCES "public"."users"("id") ON DELETE no action ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "market_prices" ADD CONSTRAINT "market_prices_global_item_id_global_items_id_fk" FOREIGN KEY ("global_item_id") REFERENCES "public"."global_items"("id") ON DELETE cascade ON UPDATE no action;

drizzle-pg/meta/_journal.json

@@ -36,6 +36,20 @@
       "when": 1776016552627,
       "tag": "0004_smiling_night_nurse",
       "breakpoints": true
+    },
+    {
+      "idx": 5,
+      "version": "7",
+      "when": 1776095449827,
+      "tag": "0005_true_green_goblin",
+      "breakpoints": true
+    },
+    {
+      "idx": 6,
+      "version": "7",
+      "when": 1776096142720,
+      "tag": "0006_remarkable_susan_delgado",
+      "breakpoints": true
     }
   ]
 }

package.json

@@ -48,11 +48,14 @@
 		"drizzle-orm": "^0.45.1",
 		"framer-motion": "^12.38.0",
 		"hono": "^4.12.8",
+		"i18next": "^26.0.4",
+		"i18next-browser-languagedetector": "^8.2.1",
 		"lucide-react": "^0.577.0",
 		"postgres": "^3.4.9",
 		"react": "^19.2.4",
 		"react-dom": "^19.2.4",
 		"react-easy-crop": "^5.5.7",
+		"react-i18next": "^17.0.2",
 		"recharts": "^3.8.0",
 		"sharp": "^0.34.5",
 		"sonner": "^2.0.7",

src/client/components/AuthPromptModal.tsx

@@ -1,7 +1,9 @@
 import { Link } from "@tanstack/react-router";
+import { useTranslation } from "react-i18next";
 import { useUIStore } from "../stores/uiStore";
 
 export function AuthPromptModal() {
+	const { t } = useTranslation();
 	const showAuthPrompt = useUIStore((s) => s.showAuthPrompt);
 	const closeAuthPrompt = useUIStore((s) => s.closeAuthPrompt);
 
@@ -18,10 +20,10 @@ export function AuthPromptModal() {
 			/>
 			<div className="relative bg-white rounded-xl shadow-lg p-6 max-w-sm mx-4 w-full">
 				<h3 className="text-lg font-semibold text-gray-900 mb-2">
-					Join GearBox
+					{t("auth.joinGearBox")}
 				</h3>
 				<p className="text-sm text-gray-600 mb-6">
-					To manage your own collection, sign in or sign up.
+					{t("auth.signInDescription")}
 				</p>
 				<div className="flex flex-col gap-3">
 					<Link
@@ -29,14 +31,14 @@ export function AuthPromptModal() {
 						className="w-full text-center px-4 py-2.5 text-sm font-medium text-white bg-gray-700 hover:bg-gray-800 rounded-lg transition-colors"
 						onClick={closeAuthPrompt}
 					>
-						Sign in
+						{t("auth.signIn")}
 					</Link>
 					<Link
 						to="/login"
 						className="w-full text-center px-4 py-2.5 text-sm font-medium text-gray-700 bg-gray-100 hover:bg-gray-200 rounded-lg transition-colors"
 						onClick={closeAuthPrompt}
 					>
-						Create account
+						{t("auth.createAccount")}
 					</Link>
 				</div>
 			</div>

src/client/components/BottomTabBar.tsx

@@ -1,5 +1,6 @@
 import { Link, useMatchRoute } from "@tanstack/react-router";
 import { motion } from "framer-motion";
+import { useTranslation } from "react-i18next";
 import { useAuth } from "../hooks/useAuth";
 import { LucideIcon } from "../lib/iconData";
 import { useUIStore } from "../stores/uiStore";
@@ -26,6 +27,7 @@ function TabItemWrapper({ icon, label, isActive }: TabItemProps) {
 }
 
 export function BottomTabBar() {
+	const { t } = useTranslation();
 	const { data: auth } = useAuth();
 	const isAuthenticated = !!auth?.user;
 	const openCatalogSearch = useUIStore((s) => s.openCatalogSearch);
@@ -46,7 +48,11 @@ export function BottomTabBar() {
 			<div className="flex justify-around">
 				{/* Home tab — always a Link */}
 				<Link to="/">
-					<TabItemWrapper icon="house" label="Home" isActive={isHome} />
+					<TabItemWrapper
+						icon="house"
+						label={t("nav.home")}
+						isActive={isHome}
+					/>
 				</Link>
 
 				{/* Collection tab — Link if authenticated, button if anonymous */}
@@ -54,7 +60,7 @@ export function BottomTabBar() {
 					<Link to="/collection">
 						<TabItemWrapper
 							icon="package"
-							label="Collection"
+							label={t("nav.collection")}
 							isActive={isCollection}
 						/>
 					</Link>
@@ -62,7 +68,7 @@ export function BottomTabBar() {
 					<button type="button" onClick={openAuthPrompt}>
 						<TabItemWrapper
 							icon="package"
-							label="Collection"
+							label={t("nav.collection")}
 							isActive={isCollection}
 						/>
 					</button>
@@ -71,17 +77,29 @@ export function BottomTabBar() {
 				{/* Setups tab — Link if authenticated, button if anonymous */}
 				{isAuthenticated ? (
 					<Link to="/setups">
-						<TabItemWrapper icon="layers" label="Setups" isActive={isSetups} />
+						<TabItemWrapper
+							icon="layers"
+							label={t("nav.setups")}
+							isActive={isSetups}
+						/>
 					</Link>
 				) : (
 					<button type="button" onClick={openAuthPrompt}>
-						<TabItemWrapper icon="layers" label="Setups" isActive={isSetups} />
+						<TabItemWrapper
+							icon="layers"
+							label={t("nav.setups")}
+							isActive={isSetups}
+						/>
 					</button>
 				)}
 
 				{/* Search tab — always a button, opens CatalogSearchOverlay */}
 				<button type="button" onClick={() => openCatalogSearch("collection")}>
-					<TabItemWrapper icon="search" label="Search" isActive={false} />
+					<TabItemWrapper
+						icon="search"
+						label={t("nav.search")}
+						isActive={false}
+					/>
 				</button>
 			</div>
 		</motion.div>

src/client/components/ConfirmDialog.tsx

@@ -1,7 +1,9 @@
+import { useTranslation } from "react-i18next";
 import { useDeleteItem, useItems } from "../hooks/useItems";
 import { useUIStore } from "../stores/uiStore";
 
 export function ConfirmDialog() {
+	const { t } = useTranslation();
 	const confirmDeleteItemId = useUIStore((s) => s.confirmDeleteItemId);
 	const closeConfirmDelete = useUIStore((s) => s.closeConfirmDelete);
 	const deleteItem = useDeleteItem();
@@ -30,12 +32,10 @@ export function ConfirmDialog() {
 			/>
 			<div className="relative bg-white rounded-xl shadow-lg p-6 max-w-sm mx-4 w-full">
 				<h3 className="text-lg font-semibold text-gray-900 mb-2">
-					Delete Item
+					{t("confirm.deleteItem")}
 				</h3>
 				<p className="text-sm text-gray-600 mb-6">
-					Are you sure you want to delete{" "}
-					<span className="font-medium">{itemName}</span>? This action cannot be
-					undone.
+					{t("confirm.deleteItemMessage", { name: itemName })}
 				</p>
 				<div className="flex justify-end gap-3">
 					<button
@@ -43,7 +43,7 @@ export function ConfirmDialog() {
 						onClick={closeConfirmDelete}
 						className="px-4 py-2 text-sm font-medium text-gray-700 bg-gray-100 hover:bg-gray-200 rounded-lg transition-colors"
 					>
-						Cancel
+						{t("actions.cancel")}
 					</button>
 					<button
 						type="button"
@@ -51,7 +51,7 @@ export function ConfirmDialog() {
 						disabled={deleteItem.isPending}
 						className="px-4 py-2 text-sm font-medium text-white bg-red-600 hover:bg-red-700 disabled:opacity-50 rounded-lg transition-colors"
 					>
-						{deleteItem.isPending ? "Deleting..." : "Delete"}
+						{deleteItem.isPending ? t("actions.deleting") : t("actions.delete")}
 					</button>
 				</div>
 			</div>

src/client/components/ExternalLinkDialog.tsx

@@ -1,7 +1,9 @@
 import { useEffect } from "react";
+import { useTranslation } from "react-i18next";
 import { useUIStore } from "../stores/uiStore";
 
 export function ExternalLinkDialog() {
+	const { t } = useTranslation();
 	const externalLinkUrl = useUIStore((s) => s.externalLinkUrl);
 	const closeExternalLink = useUIStore((s) => s.closeExternalLink);
 
@@ -35,9 +37,11 @@ export function ExternalLinkDialog() {
 			/>
 			<div className="relative bg-white rounded-xl shadow-lg p-6 max-w-sm mx-4 w-full">
 				<h3 className="text-lg font-semibold text-gray-900 mb-2">
-					You are about to leave GearBox
+					{t("externalLink.title")}
 				</h3>
-				<p className="text-sm text-gray-600 mb-1">You will be redirected to:</p>
+				<p className="text-sm text-gray-600 mb-1">
+					{t("externalLink.redirectMessage")}
+				</p>
 				<p className="text-sm text-gray-600 break-all mb-6">
 					{externalLinkUrl}
 				</p>
@@ -47,14 +51,14 @@ export function ExternalLinkDialog() {
 						onClick={closeExternalLink}
 						className="px-4 py-2 text-sm font-medium text-gray-700 bg-gray-100 hover:bg-gray-200 rounded-lg transition-colors"
 					>
-						Cancel
+						{t("actions.cancel")}
 					</button>
 					<button
 						type="button"
 						onClick={handleContinue}
 						className="px-4 py-2 text-sm font-medium text-white bg-gray-700 hover:bg-gray-800 rounded-lg transition-colors"
 					>
-						Continue
+						{t("actions.continue")}
 					</button>
 				</div>
 			</div>

src/client/components/FabMenu.tsx

@@ -1,5 +1,6 @@
 import { AnimatePresence, motion } from "framer-motion";
 import { Package, Plus, Search } from "lucide-react";
+import { useTranslation } from "react-i18next";
 import { useUIStore } from "../stores/uiStore";
 
 interface FabMenuProps {
@@ -15,6 +16,7 @@ interface MenuItem {
 }
 
 export function FabMenu({ isSetupsPage }: FabMenuProps) {
+	const { t } = useTranslation();
 	const fabMenuOpen = useUIStore((s) => s.fabMenuOpen);
 	const openFabMenu = useUIStore((s) => s.openFabMenu);
 	const closeFabMenu = useUIStore((s) => s.closeFabMenu);
@@ -26,12 +28,12 @@ export function FabMenu({ isSetupsPage }: FabMenuProps) {
 
 	const menuItems: MenuItem[] = [
 		{
-			label: "Add to Collection",
+			label: t("fab.addToCollection"),
 			icon: <Package className="w-5 h-5 text-gray-600" />,
 			onClick: () => openCatalogSearch("collection"),
 		},
 		{
-			label: "Start New Thread",
+			label: t("fab.startNewThread"),
 			icon: <Search className="w-5 h-5 text-gray-600" />,
 			onClick: () => openCatalogSearch("thread"),
 		},
@@ -39,7 +41,7 @@ export function FabMenu({ isSetupsPage }: FabMenuProps) {
 
 	if (isSetupsPage) {
 		menuItems.push({
-			label: "New Setup",
+			label: t("fab.newSetup"),
 			icon: <Plus className="w-5 h-5 text-gray-600" />,
 			onClick: () => {
 				closeFabMenu();

src/client/components/ItemCard.tsx

@@ -25,6 +25,7 @@ interface ItemCardProps {
 	onRemove?: () => void;
 	classification?: string;
 	onClassificationCycle?: () => void;
+	linkTo?: string | null;
 }
 
 export function ItemCard({
@@ -46,19 +47,29 @@ export function ItemCard({
 	onRemove,
 	classification,
 	onClassificationCycle,
+	linkTo,
 }: ItemCardProps) {
 	const { weight, price } = useFormatters();
 	const navigate = useNavigate();
 	const openExternalLink = useUIStore((s) => s.openExternalLink);
 	const duplicateItem = useDuplicateItem();
 
+	const handleClick =
+		linkTo === null
+			? undefined
+			: () => {
+					if (linkTo) {
+						navigate({ to: linkTo });
+					} else {
+						navigate({ to: "/items/$itemId", params: { itemId: String(id) } });
+					}
+				};
+
 	return (
 		<button
 			type="button"
-			onClick={() =>
-				navigate({ to: "/items/$itemId", params: { itemId: String(id) } })
-			}
-			className="relative w-full text-left bg-white rounded-xl border border-gray-100 hover:border-gray-200 hover:shadow-sm transition-all overflow-hidden group"
+			onClick={handleClick}
+			className={`relative w-full text-left bg-white rounded-xl border border-gray-100 transition-all overflow-hidden group ${linkTo === null ? "cursor-default" : "hover:border-gray-200 hover:shadow-sm"}`}
 		>
 			{!onRemove && (
 				<span

src/client/components/SetupCard.tsx

@@ -4,7 +4,7 @@ import { useFormatters } from "../hooks/useFormatters";
 interface SetupCardProps {
 	id: number;
 	name: string;
-	isPublic?: boolean;
+	visibility?: "private" | "link" | "public";
 	itemCount: number;
 	totalWeight: number;
 	totalCost: number;
@@ -13,7 +13,7 @@ interface SetupCardProps {
 export function SetupCard({
 	id,
 	name,
-	isPublic,
+	visibility,
 	itemCount,
 	totalWeight,
 	totalCost,
@@ -30,9 +30,15 @@ export function SetupCard({
 					<h3 className="text-sm font-semibold text-gray-900 truncate">
 						{name}
 					</h3>
-					{isPublic && (
-						<span className="inline-flex items-center px-1.5 py-0.5 rounded-full text-[10px] font-medium bg-green-50 text-green-600 shrink-0">
-							Public
+					{visibility && visibility !== "private" && (
+						<span
+							className={`inline-flex items-center px-1.5 py-0.5 rounded-full text-[10px] font-medium shrink-0 ${
+								visibility === "public"
+									? "bg-green-50 text-green-600"
+									: "bg-blue-50 text-blue-600"
+							}`}
+						>
+							{visibility === "public" ? "Public" : "Link"}
 						</span>
 					)}
 				</div>

src/client/components/SetupsView.tsx

@@ -100,7 +100,7 @@ export function SetupsView() {
 							key={setup.id}
 							id={setup.id}
 							name={setup.name}
-							isPublic={setup.isPublic}
+							visibility={setup.visibility}
 							itemCount={setup.itemCount}
 							totalWeight={setup.totalWeight}
 							totalCost={setup.totalCost}

src/client/components/ShareModal.tsx

@@ -0,0 +1,295 @@
+import { useEffect, useState } from "react";
+import {
+	useCreateShareLink,
+	useRevokeShareLink,
+	useShareLinks,
+} from "../hooks/useShares";
+import { LucideIcon } from "../lib/iconData";
+
+interface ShareModalProps {
+	isOpen: boolean;
+	onClose: () => void;
+	setupId: number;
+	currentVisibility: "private" | "link" | "public";
+	onVisibilityChange: (visibility: "private" | "link" | "public") => void;
+}
+
+const VISIBILITY_OPTIONS = [
+	{
+		value: "private" as const,
+		icon: "lock",
+		label: "Private",
+		description: "Only you can access",
+		color: "gray",
+		border: "border-gray-200",
+		selectedBorder: "border-gray-300 bg-gray-50",
+		iconColor: "text-gray-500",
+	},
+	{
+		value: "link" as const,
+		icon: "link",
+		label: "Link sharing",
+		description: "Anyone with the link",
+		color: "blue",
+		border: "border-gray-200",
+		selectedBorder: "border-blue-200 bg-blue-50",
+		iconColor: "text-blue-600",
+	},
+	{
+		value: "public" as const,
+		icon: "globe",
+		label: "Public",
+		description: "Visible on your profile",
+		color: "green",
+		border: "border-gray-200",
+		selectedBorder: "border-green-200 bg-green-50",
+		iconColor: "text-green-700",
+	},
+] as const;
+
+const EXPIRATION_OPTIONS = [
+	{ value: 7, label: "7 days" },
+	{ value: 14, label: "14 days" },
+	{ value: 30, label: "30 days" },
+	{ value: null, label: "No expiration" },
+] as const;
+
+export function ShareModal({
+	isOpen,
+	onClose,
+	setupId,
+	currentVisibility,
+	onVisibilityChange,
+}: ShareModalProps) {
+	const { data: shareLinks } = useShareLinks(isOpen ? setupId : null);
+	const createShareLink = useCreateShareLink(setupId);
+	const revokeShareLink = useRevokeShareLink(setupId);
+
+	const [expiresInDays, setExpiresInDays] = useState<number | null>(14);
+	const [copiedId, setCopiedId] = useState<number | null>(null);
+	const [justCreatedToken, setJustCreatedToken] = useState<string | null>(null);
+
+	// Handle Escape key
+	useEffect(() => {
+		if (!isOpen) return;
+		function handleKeyDown(e: KeyboardEvent) {
+			if (e.key === "Escape") onClose();
+		}
+		document.addEventListener("keydown", handleKeyDown);
+		return () => document.removeEventListener("keydown", handleKeyDown);
+	}, [isOpen, onClose]);
+
+	if (!isOpen) return null;
+
+	const activeLinks = shareLinks?.filter((link) => !link.revokedAt) ?? [];
+	const showLinksSection =
+		currentVisibility === "link" || currentVisibility === "public";
+	const switchingToPrivateWithLinks =
+		currentVisibility !== "private" && activeLinks.length > 0;
+
+	function handleCreateLink() {
+		createShareLink.mutate(
+			{ expiresInDays },
+			{
+				onSuccess: (share) => {
+					const url = `${window.location.origin}/s/${share.token}`;
+					navigator.clipboard.writeText(url).catch(() => {});
+					setJustCreatedToken(share.token);
+					setTimeout(() => setJustCreatedToken(null), 2000);
+				},
+			},
+		);
+	}
+
+	function handleCopy(token: string, shareId: number) {
+		const url = `${window.location.origin}/s/${token}`;
+		navigator.clipboard.writeText(url).catch(() => {});
+		setCopiedId(shareId);
+		setTimeout(() => setCopiedId(null), 2000);
+	}
+
+	function handleVisibilityChange(
+		newVisibility: "private" | "link" | "public",
+	) {
+		if (newVisibility !== currentVisibility) {
+			onVisibilityChange(newVisibility);
+		}
+	}
+
+	function formatExpiration(expiresAt: string | null) {
+		if (!expiresAt) return "No expiration";
+		const date = new Date(expiresAt);
+		const now = new Date();
+		if (date < now) return "Expired";
+		const days = Math.ceil(
+			(date.getTime() - now.getTime()) / (1000 * 60 * 60 * 24),
+		);
+		if (days === 0) return "Expires today";
+		if (days === 1) return "Expires tomorrow";
+		return `Expires in ${days} days`;
+	}
+
+	return (
+		<div className="fixed inset-0 z-50 flex items-center justify-center">
+			{/* Overlay */}
+			<div
+				className="absolute inset-0 bg-black/50"
+				onClick={onClose}
+				onKeyDown={() => {}}
+			/>
+
+			{/* Modal */}
+			<div className="relative bg-white rounded-xl shadow-lg p-6 max-w-md mx-4 w-full max-h-[80vh] overflow-y-auto">
+				{/* Header */}
+				<div className="flex items-center justify-between mb-4">
+					<h3 className="text-lg font-semibold text-gray-900">Share Setup</h3>
+					<button
+						type="button"
+						onClick={onClose}
+						className="p-1 text-gray-400 hover:text-gray-600 rounded"
+					>
+						<LucideIcon name="x" size={20} />
+					</button>
+				</div>
+
+				{/* Visibility Picker */}
+				<div className="flex flex-col gap-2 mb-4">
+					{VISIBILITY_OPTIONS.map((option) => (
+						<button
+							key={option.value}
+							type="button"
+							onClick={() => handleVisibilityChange(option.value)}
+							className={`flex items-center gap-3 p-3 rounded-lg border cursor-pointer transition-colors ${
+								currentVisibility === option.value
+									? option.selectedBorder
+									: `${option.border} hover:border-gray-300`
+							}`}
+						>
+							<LucideIcon
+								name={option.icon}
+								size={20}
+								className={option.iconColor}
+							/>
+							<div className="text-left">
+								<div className="text-sm font-medium text-gray-900">
+									{option.label}
+								</div>
+								<div className="text-xs text-gray-500">
+									{option.description}
+								</div>
+							</div>
+						</button>
+					))}
+				</div>
+
+				{/* Deactivation Warning */}
+				{currentVisibility === "private" && switchingToPrivateWithLinks && (
+					<div className="flex items-start gap-2 p-3 bg-amber-50 border border-amber-200 rounded-lg mb-4">
+						<LucideIcon
+							name="alert-triangle"
+							size={16}
+							className="text-amber-500 mt-0.5 shrink-0"
+						/>
+						<p className="text-xs text-amber-700">
+							Switching to private will deactivate all share links. They can be
+							reactivated by switching back.
+						</p>
+					</div>
+				)}
+
+				{/* Share Links Section */}
+				{showLinksSection && (
+					<div className="border-t border-gray-100 pt-4 mt-2">
+						<div className="text-sm font-medium text-gray-700 mb-3">
+							Share Links
+						</div>
+
+						{/* Create Link Row */}
+						<div className="flex items-center gap-2 mb-4">
+							<select
+								value={expiresInDays === null ? "null" : String(expiresInDays)}
+								onChange={(e) =>
+									setExpiresInDays(
+										e.target.value === "null" ? null : Number(e.target.value),
+									)
+								}
+								className="px-3 py-2 text-sm border border-gray-200 rounded-lg bg-white"
+							>
+								{EXPIRATION_OPTIONS.map((opt) => (
+									<option
+										key={String(opt.value)}
+										value={opt.value === null ? "null" : String(opt.value)}
+									>
+										{opt.label}
+									</option>
+								))}
+							</select>
+							<button
+								type="button"
+								onClick={handleCreateLink}
+								disabled={createShareLink.isPending}
+								className="px-4 py-2 bg-gray-700 hover:bg-gray-800 disabled:opacity-50 text-white text-sm font-medium rounded-lg transition-colors"
+							>
+								{createShareLink.isPending ? "Creating..." : "Create Link"}
+							</button>
+						</div>
+
+						{/* Active Links List */}
+						{activeLinks.length > 0 ? (
+							<div className="space-y-2">
+								{activeLinks.map((link) => (
+									<div
+										key={link.id}
+										className="flex items-center gap-2 p-3 bg-gray-50 rounded-lg"
+									>
+										<span className="text-sm text-gray-600 truncate flex-1">
+											{window.location.origin}/s/
+											{link.token.slice(0, 8)}...
+										</span>
+										<span className="text-xs text-gray-400 shrink-0">
+											{formatExpiration(link.expiresAt)}
+										</span>
+										<button
+											type="button"
+											onClick={() => handleCopy(link.token, link.id)}
+											className="p-1.5 text-gray-400 hover:text-gray-600 rounded"
+											title="Copy link"
+										>
+											<LucideIcon
+												name={
+													copiedId === link.id ||
+													justCreatedToken === link.token
+														? "check"
+														: "copy"
+												}
+												size={16}
+												className={
+													copiedId === link.id ||
+													justCreatedToken === link.token
+														? "text-green-500"
+														: ""
+												}
+											/>
+										</button>
+										<button
+											type="button"
+											onClick={() => revokeShareLink.mutate(link.id)}
+											className="p-1.5 text-gray-400 hover:text-red-500 rounded"
+											title="Revoke link"
+										>
+											<LucideIcon name="x" size={16} />
+										</button>
+									</div>
+								))}
+							</div>
+						) : (
+							<p className="text-sm text-gray-400 text-center py-4">
+								No share links yet
+							</p>
+						)}
+					</div>
+				)}
+			</div>
+		</div>
+	);
+}

src/client/components/TopNav.tsx

@@ -1,5 +1,6 @@
 import { Link, useMatchRoute, useNavigate } from "@tanstack/react-router";
 import { useState } from "react";
+import { useTranslation } from "react-i18next";
 import { useAuth } from "../hooks/useAuth";
 import { LucideIcon } from "../lib/iconData";
 import { useUIStore } from "../stores/uiStore";
@@ -42,6 +43,7 @@ function NavLinkOrButton({
 }
 
 export function TopNav() {
+	const { t } = useTranslation();
 	const { data: auth } = useAuth();
 	const isAuthenticated = !!auth?.user;
 	const openAuthPrompt = useUIStore((s) => s.openAuthPrompt);
@@ -82,7 +84,7 @@ export function TopNav() {
 							isAuthenticated={isAuthenticated}
 							onAuthPrompt={openAuthPrompt}
 						>
-							Home
+							{t("nav.home")}
 						</NavLinkOrButton>
 						<NavLinkOrButton
 							to="/collection"
@@ -91,7 +93,7 @@ export function TopNav() {
 							isAuthenticated={isAuthenticated}
 							onAuthPrompt={openAuthPrompt}
 						>
-							Collection
+							{t("nav.collection")}
 						</NavLinkOrButton>
 						<NavLinkOrButton
 							to="/setups"
@@ -100,7 +102,7 @@ export function TopNav() {
 							isAuthenticated={isAuthenticated}
 							onAuthPrompt={openAuthPrompt}
 						>
-							Setups
+							{t("nav.setups")}
 						</NavLinkOrButton>
 					</nav>
 
@@ -124,7 +126,7 @@ export function TopNav() {
 								onKeyDown={(e) => {
 									if (e.key === "Enter") handleSearch();
 								}}
-								placeholder="Search catalog..."
+								placeholder={t("nav.searchPlaceholder")}
 								className="bg-gray-50 border border-gray-200 rounded-lg pl-9 pr-3 py-2 text-sm text-gray-900 placeholder-gray-400 focus:outline-none focus:ring-2 focus:ring-gray-200 focus:border-gray-300 w-48 lg:w-64 transition-colors"
 							/>
 						</div>
@@ -137,7 +139,7 @@ export function TopNav() {
 								to="/login"
 								className="text-xs text-gray-500 hover:text-gray-700 transition-colors"
 							>
-								Sign in
+								{t("auth.signIn")}
 							</Link>
 						)}
 					</div>

src/client/components/UserMenu.tsx

@@ -1,10 +1,12 @@
 import { Link } from "@tanstack/react-router";
 import { useEffect, useRef, useState } from "react";
+import { useTranslation } from "react-i18next";
 import { useAuth, useLogout } from "../hooks/useAuth";
 import { usePublicProfile } from "../hooks/useProfile";
 import { LucideIcon } from "../lib/iconData";
 
 export function UserMenu() {
+	const { t } = useTranslation();
 	const [open, setOpen] = useState(false);
 	const menuRef = useRef<HTMLDivElement>(null);
 	const { logout } = useLogout();
@@ -34,7 +36,7 @@ export function UserMenu() {
 				{avatarUrl ? (
 					<img
 						src={avatarUrl}
-						alt="Profile"
+						alt={t("nav.profile")}
 						className="w-8 h-8 rounded-full object-cover"
 					/>
 				) : (
@@ -53,7 +55,7 @@ export function UserMenu() {
 							size={16}
 							className="text-gray-400"
 						/>
-						Profile
+						{t("nav.profile")}
 					</Link>
 					<Link
 						to="/settings"
@@ -61,7 +63,7 @@ export function UserMenu() {
 						className="flex items-center gap-2 px-3 py-2 text-sm text-gray-700 hover:bg-gray-50 transition-colors"
 					>
 						<LucideIcon name="settings" size={16} className="text-gray-400" />
-						Settings
+						{t("nav.settings")}
 					</Link>
 					<div className="border-t border-gray-100 my-1" />
 					<button
@@ -73,7 +75,7 @@ export function UserMenu() {
 						className="flex items-center gap-2 w-full px-3 py-2 text-sm text-gray-700 hover:bg-gray-50 transition-colors"
 					>
 						<LucideIcon name="log-out" size={16} className="text-gray-400" />
-						Sign out
+						{t("auth.signOut")}
 					</button>
 				</div>
 			)}

src/client/components/onboarding/OnboardingDone.tsx

@@ -1,3 +1,4 @@
+import { useTranslation } from "react-i18next";
 import { LucideIcon } from "../../lib/iconData";
 
 interface OnboardingDoneProps {
@@ -9,6 +10,7 @@ export function OnboardingDone({
 	itemsCreated: _itemsCreated,
 	onFinish,
 }: OnboardingDoneProps) {
+	const { t } = useTranslation("onboarding");
 	return (
 		<div className="flex flex-col items-center justify-center min-h-screen px-8">
 			<div className="max-w-2xl text-center">
@@ -20,18 +22,15 @@ export function OnboardingDone({
 					/>
 				</div>
 				<h1 className="text-3xl font-bold text-gray-900 mb-2">
-					You're all set!
+					{t("done.title")}
 				</h1>
-				<p className="text-base text-gray-500 mb-8">
-					Your collection is ready. Browse the catalog anytime to discover more
-					gear.
-				</p>
+				<p className="text-base text-gray-500 mb-8">{t("done.subtitle")}</p>
 				<button
 					type="button"
 					onClick={onFinish}
 					className="px-8 py-3 bg-gray-700 hover:bg-gray-800 text-white font-medium rounded-lg transition-colors"
 				>
-					Start exploring
+					{t("done.cta")}
 				</button>
 			</div>
 		</div>

src/client/components/onboarding/OnboardingHobbyPicker.tsx

@@ -1,3 +1,4 @@
+import { useTranslation } from "react-i18next";
 import { HOBBIES } from "@/shared/hobbyConfig";
 import { HobbyCard } from "./HobbyCard";
 
@@ -12,15 +13,14 @@ export function OnboardingHobbyPicker({
 	onToggleHobby,
 	onContinue,
 }: OnboardingHobbyPickerProps) {
+	const { t } = useTranslation("onboarding");
 	return (
 		<div className="flex flex-col items-center justify-center min-h-screen px-8">
 			<div className="max-w-2xl text-center">
 				<h1 className="text-3xl font-bold text-gray-900 mb-2">
-					What are you into?
+					{t("hobby.title")}
 				</h1>
-				<p className="text-base text-gray-500 mb-8">
-					Pick one or more — we'll show you popular gear for each.
-				</p>
+				<p className="text-base text-gray-500 mb-8">{t("hobby.subtitle")}</p>
 				<div className="flex flex-wrap justify-center gap-4 mb-8">
 					{HOBBIES.map((hobby) => (
 						<HobbyCard
@@ -39,7 +39,7 @@ export function OnboardingHobbyPicker({
 					disabled={selectedHobbies.length === 0}
 					className="px-8 py-3 bg-gray-700 hover:bg-gray-800 disabled:opacity-50 disabled:cursor-not-allowed text-white font-medium rounded-lg transition-colors"
 				>
-					Continue
+					{t("hobby.continue")}
 				</button>
 			</div>
 		</div>

src/client/components/onboarding/OnboardingItemBrowser.tsx

@@ -1,3 +1,4 @@
+import { useTranslation } from "react-i18next";
 import { getTagsForHobbies } from "@/shared/hobbyConfig";
 import { usePopularItems } from "../../hooks/useOnboarding";
 import { SelectableItemCard } from "./SelectableItemCard";
@@ -17,6 +18,7 @@ export function OnboardingItemBrowser({
 	onContinue,
 	onSkip,
 }: OnboardingItemBrowserProps) {
+	const { t } = useTranslation("onboarding");
 	const tags = getTagsForHobbies(selectedHobbies);
 	const { data: items, isLoading } = usePopularItems(tags);
 
@@ -48,12 +50,11 @@ export function OnboardingItemBrowser({
 		<div className="flex flex-col items-center min-h-screen px-8 py-16">
 			<div className="max-w-5xl w-full text-center">
 				<h1 className="text-3xl font-bold text-gray-900 mb-2">
-					Popular gear for{" "}
-					{selectedHobbies.length === 1 ? selectedHobbies[0] : "your hobbies"}
+					{selectedHobbies.length === 1
+						? t("items.title", { hobby: selectedHobbies[0] })
+						: t("items.titleMultiple")}
 				</h1>
-				<p className="text-base text-gray-500 mb-8">
-					Tap items you already own. We'll add them to your collection.
-				</p>
+				<p className="text-base text-gray-500 mb-8">{t("items.subtitle")}</p>
 
 				{isLoading && (
 					<div className="flex justify-center py-12">
@@ -64,11 +65,10 @@ export function OnboardingItemBrowser({
 				{!isLoading && !hasItems && (
 					<div className="py-12 text-center">
 						<h2 className="text-lg font-semibold text-gray-900 mb-2">
-							No gear cataloged yet
+							{t("items.noCatalog")}
 						</h2>
 						<p className="text-base text-gray-500 mb-8">
-							We're still building our catalog for this hobby. You can skip this
-							step and add gear manually later.
+							{t("items.noCatalogDescription")}
 						</p>
 					</div>
 				)}
@@ -105,8 +105,7 @@ export function OnboardingItemBrowser({
 							onClick={onContinue}
 							className="px-8 py-3 bg-gray-700 hover:bg-gray-800 text-white font-medium rounded-lg transition-colors"
 						>
-							Review {selectedItemIds.size}{" "}
-							{selectedItemIds.size === 1 ? "item" : "items"}
+							{t("items.reviewCount", { count: selectedItemIds.size })}
 						</button>
 					)}
 					<button
@@ -114,7 +113,7 @@ export function OnboardingItemBrowser({
 						onClick={onSkip}
 						className="text-sm text-gray-400 hover:text-gray-600 transition-colors"
 					>
-						Skip this step
+						{t("common:actions.skipStep")}
 					</button>
 				</div>
 			</div>

src/client/components/onboarding/OnboardingReview.tsx

@@ -1,3 +1,4 @@
+import { useTranslation } from "react-i18next";
 import { LucideIcon } from "../../lib/iconData";
 
 interface ReviewItem {
@@ -23,6 +24,7 @@ export function OnboardingReview({
 	onSkip,
 	isSubmitting,
 }: OnboardingReviewProps) {
+	const { t } = useTranslation("onboarding");
 	// Group by category
 	const grouped = new Map<string, ReviewItem[]>();
 	for (const item of items) {
@@ -35,12 +37,12 @@ export function OnboardingReview({
 		<div className="flex flex-col items-center justify-center min-h-screen px-8">
 			<div className="max-w-2xl w-full text-center">
 				<h1 className="text-3xl font-bold text-gray-900 mb-2">
-					Your starting collection
+					{t("review.title")}
 				</h1>
 				<p className="text-base text-gray-500 mb-8">
 					{items.length > 0
-						? `${items.length} ${items.length === 1 ? "item" : "items"} ready to add`
-						: "No items selected — you can always add gear later from the catalog."}
+						? t("review.itemsReady", { count: items.length })
+						: t("review.noItemsSelected")}
 				</p>
 
 				{items.length > 0 && (
@@ -101,7 +103,7 @@ export function OnboardingReview({
 							disabled={isSubmitting}
 							className="px-8 py-3 bg-gray-700 hover:bg-gray-800 disabled:opacity-50 text-white font-medium rounded-lg transition-colors"
 						>
-							{isSubmitting ? "Adding..." : "Add to my collection"}
+							{isSubmitting ? t("review.adding") : t("review.addToCollection")}
 						</button>
 					) : (
 						<button
@@ -109,7 +111,7 @@ export function OnboardingReview({
 							onClick={onSkip}
 							className="px-8 py-3 bg-gray-700 hover:bg-gray-800 text-white font-medium rounded-lg transition-colors"
 						>
-							Continue
+							{t("common:actions.continue")}
 						</button>
 					)}
 					{items.length > 0 && (
@@ -118,7 +120,7 @@ export function OnboardingReview({
 							onClick={onSkip}
 							className="text-sm text-gray-400 hover:text-gray-600 transition-colors"
 						>
-							Skip this step
+							{t("common:actions.skipStep")}
 						</button>
 					)}
 				</div>

src/client/components/onboarding/OnboardingWelcome.tsx

@@ -1,24 +1,26 @@
+import { useTranslation } from "react-i18next";
+
 interface OnboardingWelcomeProps {
 	onContinue: () => void;
 }
 
 export function OnboardingWelcome({ onContinue }: OnboardingWelcomeProps) {
+	const { t } = useTranslation("onboarding");
 	return (
 		<div className="flex flex-col items-center justify-center min-h-screen px-8">
 			<div className="max-w-2xl text-center">
 				<h1 className="text-3xl font-bold text-gray-900 mb-4">
-					Welcome to GearBox
+					{t("welcome.title")}
 				</h1>
 				<p className="text-base text-gray-500 mb-8 leading-relaxed">
-					Tell us what you're into, and we'll help you set up your collection
-					with gear that people actually use.
+					{t("welcome.subtitle")}
 				</p>
 				<button
 					type="button"
 					onClick={onContinue}
 					className="px-8 py-3 bg-gray-700 hover:bg-gray-800 text-white font-medium rounded-lg transition-colors"
 				>
-					Let's go
+					{t("welcome.cta")}
 				</button>
 			</div>
 		</div>

src/client/hooks/useCurrency.ts

@@ -3,10 +3,33 @@ import { useSetting } from "./useSettings";
 
 const VALID_CURRENCIES: Currency[] = ["USD", "EUR", "GBP", "JPY", "CAD", "AUD"];
 
-export function useCurrency(): Currency {
-	const { data } = useSetting("currency");
-	if (data && VALID_CURRENCIES.includes(data as Currency)) {
-		return data as Currency;
-	}
-	return "USD";
+const CURRENCY_MARKET_MAP: Record<string, string> = {
+	EUR: "EU",
+	USD: "US",
+	GBP: "UK",
+	JPY: "JP",
+	CAD: "CA",
+	AUD: "AU",
+};
+
+export interface CurrencyContext {
+	currency: Currency;
+	market: string;
+	showConversions: boolean;
+}
+
+export function useCurrency(): CurrencyContext {
+	const { data: currencyData } = useSetting("currency");
+	const { data: showConversionsData } = useSetting("showConversions");
+
+	const currency: Currency =
+		currencyData && VALID_CURRENCIES.includes(currencyData as Currency)
+			? (currencyData as Currency)
+			: "USD";
+
+	return {
+		currency,
+		market: CURRENCY_MARKET_MAP[currency] ?? currency,
+		showConversions: showConversionsData === "true",
+	};
 }

src/client/hooks/useExchangeRates.ts

@@ -0,0 +1,34 @@
+import { useQuery } from "@tanstack/react-query";
+import { apiGet } from "../lib/api";
+
+interface ExchangeRates {
+	base: string;
+	date: string;
+	rates: Record<string, number>;
+}
+
+export function useExchangeRates() {
+	return useQuery({
+		queryKey: ["exchange-rates"],
+		queryFn: () => apiGet<ExchangeRates>("/api/exchange-rates"),
+		staleTime: 1000 * 60 * 60, // 1 hour client-side stale time
+		gcTime: 1000 * 60 * 60 * 24, // 24 hour garbage collection
+		refetchOnWindowFocus: false,
+	});
+}
+
+/**
+ * Convert price in cents from one currency to another using provided rates.
+ * All conversions go through EUR as the base currency.
+ */
+export function convertClientPrice(
+	cents: number,
+	from: string,
+	to: string,
+	rates: Record<string, number>,
+): number {
+	if (from === to) return cents;
+	const fromRate = rates[from] ?? 1;
+	const toRate = rates[to] ?? 1;
+	return Math.round((cents / fromRate) * toRate);
+}

src/client/hooks/useFormatters.ts

@@ -1,14 +1,17 @@
 import { formatPrice, formatWeight } from "../lib/formatters";
 import { useCurrency } from "./useCurrency";
+import { useLanguage } from "./useLanguage";
 import { useWeightUnit } from "./useWeightUnit";
 
 export function useFormatters() {
 	const unit = useWeightUnit();
-	const currency = useCurrency();
+	const { currency } = useCurrency();
+	const locale = useLanguage();
 	return {
-		weight: (grams: number | null) => formatWeight(grams, unit),
-		price: (cents: number | null) => formatPrice(cents, currency),
+		weight: (grams: number | null) => formatWeight(grams, unit, locale),
+		price: (cents: number | null) => formatPrice(cents, currency, locale),
 		unit,
 		currency,
+		locale,
 	};
 }

src/client/hooks/useGlobalItems.ts

@@ -67,6 +67,43 @@ export function useLinkItem() {
 	});
 }
 
+interface MarketPriceData {
+	id: number;
+	globalItemId: number;
+	market: string;
+	currency: string;
+	priceCents: number;
+	source: string | null;
+	createdAt: string;
+}
+
+interface CommunityPriceStat {
+	market: string;
+	currency: string;
+	medianPrice: number;
+	reportCount: number;
+}
+
+export function useGlobalItemPrices(globalItemId: number) {
+	return useQuery({
+		queryKey: ["global-item-prices", globalItemId],
+		queryFn: () =>
+			apiGet<{ marketPrices: MarketPriceData[] }>(
+				`/api/market-prices/global-items/${globalItemId}/prices`,
+			),
+		enabled: globalItemId > 0,
+	});
+}
+
+export function useGlobalItemCommunityStats(globalItemId: number) {
+	return useQuery({
+		queryKey: ["global-item-community-stats", globalItemId],
+		queryFn: () =>
+			apiGet<CommunityPriceStat[]>(`/api/community-prices/${globalItemId}`),
+		enabled: globalItemId > 0,
+	});
+}
+
 export function useUnlinkItem() {
 	const queryClient = useQueryClient();
 	return useMutation({

src/client/hooks/useLanguage.ts

@@ -0,0 +1,12 @@
+import { useSetting } from "./useSettings";
+
+export const VALID_LANGUAGES = ["en", "de"] as const;
+export type Language = (typeof VALID_LANGUAGES)[number];
+
+export function useLanguage(): Language {
+	const { data } = useSetting("language");
+	if (data && VALID_LANGUAGES.includes(data as Language)) {
+		return data as Language;
+	}
+	return "en";
+}

src/client/hooks/useSetups.ts

@@ -11,7 +11,7 @@ import {
 interface SetupListItem {
 	id: number;
 	name: string;
-	isPublic: boolean;
+	visibility: "private" | "link" | "public";
 	createdAt: string;
 	updatedAt: string;
 	itemCount: number;
@@ -39,7 +39,7 @@ interface SetupItemWithCategory {
 interface SetupWithItems {
 	id: number;
 	name: string;
-	isPublic: boolean;
+	visibility: "private" | "link" | "public";
 	createdAt: string;
 	updatedAt: string;
 	items: SetupItemWithCategory[];
@@ -74,6 +74,60 @@ export function usePublicSetup(setupId: number | null) {
 	});
 }
 
+export function useSharedSetup(token: string | null) {
+	return useQuery({
+		queryKey: ["shared-setup", token],
+		queryFn: () => apiGet<SetupWithItems>(`/api/shared/${token}`),
+		enabled: !!token,
+		retry: false,
+	});
+}
+
+interface SetupItem {
+	id: number;
+	name: string;
+	brand?: string | null;
+	weightGrams: number | null;
+	priceCents: number | null;
+	quantity: number;
+	categoryId: number;
+	notes: string | null;
+	productUrl: string | null;
+	imageFilename: string | null;
+	imageUrl?: string | null;
+	globalItemId: number | null;
+	createdAt: string;
+	categoryName: string;
+	categoryIcon: string;
+	classification: string;
+}
+
+export function usePublicSetupItem(
+	setupId: number | null,
+	itemId: number | null,
+) {
+	return useQuery({
+		queryKey: ["setups", setupId, "items", itemId, "public"],
+		queryFn: () =>
+			apiGet<SetupItem>(`/api/setups/${setupId}/items/${itemId}/public`),
+		enabled: setupId != null && itemId != null,
+		retry: (count, error) =>
+			error instanceof ApiError && error.status === 404 ? false : count < 3,
+	});
+}
+
+export function useSharedSetupItem(
+	token: string | null,
+	itemId: number | null,
+) {
+	return useQuery({
+		queryKey: ["shared-setup", token, "items", itemId],
+		queryFn: () => apiGet<SetupItem>(`/api/shared/${token}/items/${itemId}`),
+		enabled: !!token && itemId != null,
+		retry: false,
+	});
+}
+
 export function useCreateSetup() {
 	const queryClient = useQueryClient();
 	return useMutation({
@@ -88,8 +142,10 @@ export function useCreateSetup() {
 export function useUpdateSetup(setupId: number) {
 	const queryClient = useQueryClient();
 	return useMutation({
-		mutationFn: (data: { name?: string; isPublic?: boolean }) =>
-			apiPut<SetupListItem>(`/api/setups/${setupId}`, data),
+		mutationFn: (data: {
+			name?: string;
+			visibility?: "private" | "link" | "public";
+		}) => apiPut<SetupListItem>(`/api/setups/${setupId}`, data),
 		onSuccess: () => {
 			queryClient.invalidateQueries({ queryKey: ["setups"] });
 		},

src/client/hooks/useShares.ts

@@ -0,0 +1,42 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { apiDelete, apiGet, apiPost } from "../lib/api";
+
+interface ShareLink {
+	id: number;
+	setupId: number;
+	token: string;
+	permission: string;
+	expiresAt: string | null;
+	createdAt: string;
+	revokedAt: string | null;
+}
+
+export function useShareLinks(setupId: number | null) {
+	return useQuery({
+		queryKey: ["shares", setupId],
+		queryFn: () => apiGet<ShareLink[]>(`/api/setups/${setupId}/shares`),
+		enabled: !!setupId,
+	});
+}
+
+export function useCreateShareLink(setupId: number) {
+	const queryClient = useQueryClient();
+	return useMutation({
+		mutationFn: (data: { expiresInDays: number | null }) =>
+			apiPost<ShareLink>(`/api/setups/${setupId}/shares`, data),
+		onSuccess: () => {
+			queryClient.invalidateQueries({ queryKey: ["shares", setupId] });
+		},
+	});
+}
+
+export function useRevokeShareLink(setupId: number) {
+	const queryClient = useQueryClient();
+	return useMutation({
+		mutationFn: (shareId: number) =>
+			apiDelete<ShareLink>(`/api/setups/${setupId}/shares/${shareId}`),
+		onSuccess: () => {
+			queryClient.invalidateQueries({ queryKey: ["shares", setupId] });
+		},
+	});
+}

src/client/lib/formatters.ts

@@ -7,39 +7,74 @@ const GRAMS_PER_KG = 1000;
 export function formatWeight(
 	grams: number | null | undefined,
 	unit: WeightUnit = "g",
+	locale = "en",
 ): string {
 	if (grams == null) return "--";
+	let value: number;
+	let fractionDigits: number;
 	switch (unit) {
 		case "g":
-			return `${Math.round(grams)}g`;
+			value = Math.round(grams);
+			fractionDigits = 0;
+			break;
 		case "oz":
-			return `${(grams / GRAMS_PER_OZ).toFixed(1)} oz`;
+			value = grams / GRAMS_PER_OZ;
+			fractionDigits = 1;
+			break;
 		case "lb":
-			return `${(grams / GRAMS_PER_LB).toFixed(2)} lb`;
+			value = grams / GRAMS_PER_LB;
+			fractionDigits = 2;
+			break;
 		case "kg":
-			return `${(grams / GRAMS_PER_KG).toFixed(2)} kg`;
+			value = grams / GRAMS_PER_KG;
+			fractionDigits = 2;
+			break;
 	}
+	const formatted = new Intl.NumberFormat(locale, {
+		minimumFractionDigits: fractionDigits,
+		maximumFractionDigits: fractionDigits,
+	}).format(value);
+	return unit === "g" ? `${formatted}g` : `${formatted} ${unit}`;
 }
 
 export type Currency = "USD" | "EUR" | "GBP" | "JPY" | "CAD" | "AUD";
 
-const CURRENCY_SYMBOLS: Record<Currency, string> = {
-	USD: "$",
-	EUR: "€",
-	GBP: "£",
-	JPY: "¥",
-	CAD: "CA$",
-	AUD: "A$",
-};
-
 export function formatPrice(
 	cents: number | null | undefined,
 	currency: Currency = "USD",
+	locale = "en",
 ): string {
 	if (cents == null) return "--";
-	const symbol = CURRENCY_SYMBOLS[currency];
-	if (currency === "JPY") {
-		return `${symbol}${Math.round(cents / 100)}`;
-	}
-	return `${symbol}${(cents / 100).toFixed(2)}`;
+	return new Intl.NumberFormat(locale, {
+		style: "currency",
+		currency,
+		minimumFractionDigits: currency === "JPY" ? 0 : 2,
+		maximumFractionDigits: currency === "JPY" ? 0 : 2,
+	}).format(cents / 100);
+}
+
+export interface DualPriceOptions {
+	sourceCents: number;
+	sourceCurrency: Currency;
+	targetCurrency: Currency;
+	convertedCents: number;
+	locale?: string;
+}
+
+/**
+ * Format a price with dual display: source price + converted in parentheses.
+ * Per D-14: "€2,000 (~£1,720)" — source prominent, converted approximate.
+ */
+export function formatDualPrice(options: DualPriceOptions): {
+	source: string;
+	converted: string;
+} {
+	const locale = options.locale ?? "en";
+	const source = formatPrice(
+		options.sourceCents,
+		options.sourceCurrency,
+		locale,
+	);
+	const converted = `~${formatPrice(options.convertedCents, options.targetCurrency, locale)}`;
+	return { source, converted };
 }

src/client/lib/i18n.ts

@@ -0,0 +1,52 @@
+import i18n from "i18next";
+import LanguageDetector from "i18next-browser-languagedetector";
+import { initReactI18next } from "react-i18next";
+import deCollection from "../locales/de/collection.json";
+import deCommon from "../locales/de/common.json";
+import deOnboarding from "../locales/de/onboarding.json";
+import deSettings from "../locales/de/settings.json";
+import deSetups from "../locales/de/setups.json";
+import deThreads from "../locales/de/threads.json";
+import enCollection from "../locales/en/collection.json";
+import enCommon from "../locales/en/common.json";
+import enOnboarding from "../locales/en/onboarding.json";
+import enSettings from "../locales/en/settings.json";
+import enSetups from "../locales/en/setups.json";
+import enThreads from "../locales/en/threads.json";
+
+i18n
+	.use(LanguageDetector)
+	.use(initReactI18next)
+	.init({
+		resources: {
+			en: {
+				common: enCommon,
+				collection: enCollection,
+				threads: enThreads,
+				setups: enSetups,
+				onboarding: enOnboarding,
+				settings: enSettings,
+			},
+			de: {
+				common: deCommon,
+				collection: deCollection,
+				threads: deThreads,
+				setups: deSetups,
+				onboarding: deOnboarding,
+				settings: deSettings,
+			},
+		},
+		supportedLngs: ["en", "de"],
+		fallbackLng: "en",
+		defaultNS: "common",
+		interpolation: {
+			escapeValue: false,
+		},
+		detection: {
+			order: ["localStorage", "navigator"],
+			lookupLocalStorage: "gearbox-language",
+			caches: ["localStorage"],
+		},
+	});
+
+export default i18n;

src/client/locales/de/collection.json

@@ -0,0 +1,31 @@
+{
+	"title": "Sammlung",
+	"gear": "Ausruestung",
+	"planning": "Planung",
+	"empty": {
+		"title": "Ihre Sammlung ist leer",
+		"description": "Beginnen Sie mit der Katalogisierung Ihrer Ausruestung, indem Sie Ihren ersten Gegenstand hinzufuegen. Verfolgen Sie Gewicht, Preis und organisieren Sie nach Kategorie.",
+		"addFirst": "Ersten Gegenstand hinzufuegen"
+	},
+	"form": {
+		"name": "Name",
+		"nameRequired": "Name *",
+		"namePlaceholder": "z.B. Osprey Talon 22",
+		"weight": "Gewicht (g)",
+		"weightPlaceholder": "z.B. 680",
+		"price": "Preis ($)",
+		"pricePlaceholder": "z.B. 129,99",
+		"quantity": "Menge",
+		"category": "Kategorie",
+		"notes": "Notizen",
+		"notesPlaceholder": "Zusaetzliche Notizen...",
+		"productLink": "Produktlink",
+		"urlPlaceholder": "https://..."
+	},
+	"classification": {
+		"ultralight": "Ultraleicht",
+		"light": "Leicht",
+		"medium": "Mittel",
+		"heavy": "Schwer"
+	}
+}

src/client/locales/de/common.json

@@ -0,0 +1,80 @@
+{
+	"nav": {
+		"home": "Startseite",
+		"collection": "Sammlung",
+		"setups": "Setups",
+		"discover": "Entdecken",
+		"settings": "Einstellungen",
+		"search": "Suchen",
+		"searchPlaceholder": "Katalog durchsuchen...",
+		"profile": "Profil"
+	},
+	"actions": {
+		"save": "Speichern",
+		"cancel": "Abbrechen",
+		"delete": "Loeschen",
+		"edit": "Bearbeiten",
+		"create": "Erstellen",
+		"close": "Schliessen",
+		"back": "Zurueck",
+		"confirm": "Bestaetigen",
+		"continue": "Weiter",
+		"tryAgain": "Erneut versuchen",
+		"dismiss": "Schliessen",
+		"saving": "Wird gespeichert...",
+		"deleting": "Wird geloescht...",
+		"creating": "Wird erstellt...",
+		"loading": "Laden...",
+		"addItem": "Gegenstand hinzufuegen",
+		"saveChanges": "Aenderungen speichern",
+		"revoke": "Widerrufen",
+		"skipStep": "Diesen Schritt ueberspringen"
+	},
+	"errors": {
+		"somethingWentWrong": "Etwas ist schiefgelaufen",
+		"unexpectedError": "Ein unerwarteter Fehler ist aufgetreten",
+		"nameRequired": "Name ist erforderlich",
+		"positiveNumber": "Muss eine positive Zahl sein",
+		"validUrl": "Muss eine gueltige URL sein (https://...)"
+	},
+	"auth": {
+		"signIn": "Anmelden",
+		"signOut": "Abmelden",
+		"joinGearBox": "GearBox beitreten",
+		"signInToGearBox": "Bei GearBox anmelden",
+		"signInDescription": "Melden Sie sich an oder erstellen Sie ein Konto, um Ihre Sammlung zu verwalten.",
+		"createAccount": "Konto erstellen",
+		"redirectDescription": "Sie werden zur Anmeldung weitergeleitet."
+	},
+	"confirm": {
+		"deleteItem": "Gegenstand loeschen",
+		"deleteItemMessage": "Sind Sie sicher, dass Sie <bold>{{name}}</bold> loeschen moechten? Diese Aktion kann nicht rueckgaengig gemacht werden.",
+		"deleteCandidate": "Kandidat loeschen",
+		"deleteCandidateMessage": "Sind Sie sicher, dass Sie <bold>{{name}}</bold> loeschen moechten? Diese Aktion kann nicht rueckgaengig gemacht werden.",
+		"pickWinner": "Gewinner waehlen",
+		"pickWinnerMessage": "<bold>{{name}}</bold> als Gewinner waehlen? Der Gegenstand wird Ihrer Sammlung hinzugefuegt und der Thread archiviert."
+	},
+	"externalLink": {
+		"title": "Sie verlassen GearBox",
+		"redirectMessage": "Sie werden weitergeleitet zu:"
+	},
+	"fab": {
+		"addToCollection": "Zur Sammlung hinzufuegen",
+		"startNewThread": "Neuen Thread starten",
+		"newSetup": "Neues Setup"
+	},
+	"empty": {
+		"noResults": "Keine Ergebnisse gefunden",
+		"noItems": "Keine Gegenstaende gefunden"
+	},
+	"stats": {
+		"items": "Gegenstaende",
+		"totalWeight": "Gesamtgewicht",
+		"totalSpent": "Gesamtausgaben"
+	},
+	"filter": {
+		"showing": "{{filtered}} von {{total}} Gegenstaenden",
+		"searchItems": "Gegenstaende suchen...",
+		"allCategories": "Alle Kategorien"
+	}
+}

src/client/locales/de/onboarding.json

@@ -0,0 +1,34 @@
+{
+	"welcome": {
+		"title": "Willkommen bei GearBox",
+		"subtitle": "Sagen Sie uns, was Sie interessiert, und wir helfen Ihnen, Ihre Sammlung mit Ausruestung einzurichten, die wirklich genutzt wird.",
+		"cta": "Los geht's"
+	},
+	"hobby": {
+		"title": "Was interessiert Sie?",
+		"subtitle": "Waehlen Sie eins oder mehrere — wir zeigen Ihnen beliebte Ausruestung fuer jedes.",
+		"continue": "Weiter"
+	},
+	"items": {
+		"title": "Beliebte Ausruestung fuer {{hobby}}",
+		"titleMultiple": "Beliebte Ausruestung fuer Ihre Hobbys",
+		"subtitle": "Tippen Sie auf Gegenstaende, die Sie bereits besitzen. Wir fuegen sie Ihrer Sammlung hinzu.",
+		"noCatalog": "Noch keine Ausruestung katalogisiert",
+		"noCatalogDescription": "Wir bauen unseren Katalog fuer dieses Hobby noch auf. Sie koennen diesen Schritt ueberspringen und spaeter manuell Ausruestung hinzufuegen.",
+		"reviewCount": "{{count}} Gegenstaende pruefen",
+		"reviewCount_one": "{{count}} Gegenstand pruefen"
+	},
+	"review": {
+		"title": "Ihre Startsammlung",
+		"itemsReady": "{{count}} Gegenstaende bereit zum Hinzufuegen",
+		"itemsReady_one": "{{count}} Gegenstand bereit zum Hinzufuegen",
+		"noItemsSelected": "Keine Gegenstaende ausgewaehlt — Sie koennen jederzeit spaeter Ausruestung aus dem Katalog hinzufuegen.",
+		"addToCollection": "Zu meiner Sammlung hinzufuegen",
+		"adding": "Wird hinzugefuegt..."
+	},
+	"done": {
+		"title": "Alles bereit!",
+		"subtitle": "Ihre Sammlung ist fertig. Durchstoebern Sie jederzeit den Katalog, um mehr Ausruestung zu entdecken.",
+		"cta": "Jetzt entdecken"
+	}
+}

src/client/locales/de/settings.json

@@ -0,0 +1,32 @@
+{
+	"title": "Einstellungen",
+	"language": {
+		"title": "Sprache",
+		"description": "Aendern Sie die Anzeigesprache der App"
+	},
+	"weightUnit": {
+		"title": "Gewichtseinheit",
+		"description": "Waehlen Sie die Einheit fuer die Gewichtsanzeige in der App"
+	},
+	"currency": {
+		"title": "Waehrung",
+		"description": "Aendert das angezeigte Waehrungssymbol. Werte werden nicht umgerechnet."
+	},
+	"apiKeys": {
+		"title": "API-Schluessel",
+		"description": "API-Schluessel ermoeglichen programmatischen Zugriff auf GearBox (z.B. von Claude Desktop oder Skripten).",
+		"copyWarning": "Kopieren Sie diesen Schluessel jetzt — er wird nicht erneut angezeigt:",
+		"namePlaceholder": "Schluesselname (z.B. claude-desktop)"
+	},
+	"importExport": {
+		"title": "Import / Export",
+		"description": "Exportieren Sie Ihre Ausruestungssammlung als CSV-Datei oder importieren Sie Gegenstaende aus einer CSV.",
+		"export": "CSV exportieren",
+		"import": "CSV importieren",
+		"importing": "Wird importiert...",
+		"imported": "{{count}} Gegenstaende importiert.",
+		"imported_one": "{{count}} Gegenstand importiert.",
+		"newCategories": "Neue Kategorien: {{categories}}",
+		"noItemsFound": "Keine Gegenstaende in der CSV gefunden."
+	}
+}

src/client/locales/de/setups.json

@@ -0,0 +1,43 @@
+{
+	"title": "Setups",
+	"create": "Neues Setup",
+	"empty": {
+		"title": "Noch keine Setups",
+		"description": "Erstellen Sie ein Setup, um Ausruestung fuer bestimmte Reisen oder Aktivitaeten zu organisieren."
+	},
+	"card": {
+		"items": "{{count}} Gegenstaende",
+		"items_one": "{{count}} Gegenstand",
+		"weight": "Gewicht",
+		"price": "Preis"
+	},
+	"share": {
+		"title": "Setup teilen",
+		"shareLinks": "Freigabelinks",
+		"createLink": "Link erstellen",
+		"noLinks": "Noch keine Freigabelinks",
+		"copyLink": "Link kopieren",
+		"revokeLink": "Link widerrufen",
+		"copied": "Kopiert!",
+		"noExpiration": "Kein Ablaufdatum",
+		"expired": "Abgelaufen",
+		"expiresToday": "Laeuft heute ab",
+		"expiresTomorrow": "Laeuft morgen ab",
+		"expiresInDays": "Laeuft in {{days}} Tagen ab",
+		"daysOption": "{{days}} Tage",
+		"deactivateWarning": "Bei Umstellung auf Privat werden alle Freigabelinks deaktiviert. Sie koennen durch Zurueckschalten reaktiviert werden."
+	},
+	"visibility": {
+		"private": "Privat",
+		"privateDescription": "Nur Sie haben Zugriff",
+		"link": "Link-Freigabe",
+		"linkDescription": "Jeder mit dem Link",
+		"public": "Oeffentlich",
+		"publicDescription": "Sichtbar auf Ihrem Profil"
+	},
+	"impact": {
+		"title": "Auswirkungsvorschau",
+		"adding": "Hinzufuegen",
+		"removing": "Entfernen"
+	}
+}

src/client/locales/de/threads.json

@@ -0,0 +1,45 @@
+{
+	"title": "Recherche-Threads",
+	"create": {
+		"title": "Neuer Thread",
+		"threadName": "Thread-Name",
+		"namePlaceholder": "z.B. Leichter Schlafsack",
+		"category": "Kategorie",
+		"nameRequired": "Thread-Name ist erforderlich",
+		"selectCategory": "Bitte waehlen Sie eine Kategorie",
+		"createFailed": "Thread konnte nicht erstellt werden",
+		"createThread": "Thread erstellen"
+	},
+	"status": {
+		"active": "Aktiv",
+		"researching": "Recherche",
+		"ordered": "Bestellt",
+		"arrived": "Angekommen",
+		"resolved": "Abgeschlossen",
+		"archived": "Archiviert"
+	},
+	"candidate": {
+		"name": "Name",
+		"price": "Preis",
+		"weight": "Gewicht",
+		"url": "URL",
+		"pros": "Vorteile",
+		"cons": "Nachteile",
+		"notes": "Notizen",
+		"addCandidate": "Kandidat hinzufuegen"
+	},
+	"comparison": {
+		"weight": "Gewicht",
+		"price": "Preis",
+		"pros": "Vorteile",
+		"cons": "Nachteile"
+	},
+	"resolve": {
+		"title": "Gewinner waehlen",
+		"message": "<bold>{{name}}</bold> als Gewinner waehlen? Der Gegenstand wird Ihrer Sammlung hinzugefuegt und der Thread archiviert."
+	},
+	"empty": {
+		"noThreads": "Noch keine Recherche-Threads",
+		"noCandidates": "Noch keine Kandidaten"
+	}
+}

src/client/locales/en/collection.json

@@ -0,0 +1,31 @@
+{
+	"title": "Collection",
+	"gear": "Gear",
+	"planning": "Planning",
+	"empty": {
+		"title": "Your collection is empty",
+		"description": "Start cataloging your gear by adding your first item. Track weight, price, and organize by category.",
+		"addFirst": "Add your first item"
+	},
+	"form": {
+		"name": "Name",
+		"nameRequired": "Name *",
+		"namePlaceholder": "e.g. Osprey Talon 22",
+		"weight": "Weight (g)",
+		"weightPlaceholder": "e.g. 680",
+		"price": "Price ($)",
+		"pricePlaceholder": "e.g. 129.99",
+		"quantity": "Quantity",
+		"category": "Category",
+		"notes": "Notes",
+		"notesPlaceholder": "Any additional notes...",
+		"productLink": "Product Link",
+		"urlPlaceholder": "https://..."
+	},
+	"classification": {
+		"ultralight": "Ultralight",
+		"light": "Light",
+		"medium": "Medium",
+		"heavy": "Heavy"
+	}
+}

src/client/locales/en/common.json

@@ -0,0 +1,80 @@
+{
+	"nav": {
+		"home": "Home",
+		"collection": "Collection",
+		"setups": "Setups",
+		"discover": "Discover",
+		"settings": "Settings",
+		"search": "Search",
+		"searchPlaceholder": "Search catalog...",
+		"profile": "Profile"
+	},
+	"actions": {
+		"save": "Save",
+		"cancel": "Cancel",
+		"delete": "Delete",
+		"edit": "Edit",
+		"create": "Create",
+		"close": "Close",
+		"back": "Back",
+		"confirm": "Confirm",
+		"continue": "Continue",
+		"tryAgain": "Try again",
+		"dismiss": "Dismiss",
+		"saving": "Saving...",
+		"deleting": "Deleting...",
+		"creating": "Creating...",
+		"loading": "Loading...",
+		"addItem": "Add Item",
+		"saveChanges": "Save Changes",
+		"revoke": "Revoke",
+		"skipStep": "Skip this step"
+	},
+	"errors": {
+		"somethingWentWrong": "Something went wrong",
+		"unexpectedError": "An unexpected error occurred",
+		"nameRequired": "Name is required",
+		"positiveNumber": "Must be a positive number",
+		"validUrl": "Must be a valid URL (https://...)"
+	},
+	"auth": {
+		"signIn": "Sign in",
+		"signOut": "Sign out",
+		"joinGearBox": "Join GearBox",
+		"signInToGearBox": "Sign in to GearBox",
+		"signInDescription": "To manage your own collection, sign in or sign up.",
+		"createAccount": "Create account",
+		"redirectDescription": "You will be redirected to sign in with your account."
+	},
+	"confirm": {
+		"deleteItem": "Delete Item",
+		"deleteItemMessage": "Are you sure you want to delete <bold>{{name}}</bold>? This action cannot be undone.",
+		"deleteCandidate": "Delete Candidate",
+		"deleteCandidateMessage": "Are you sure you want to delete <bold>{{name}}</bold>? This action cannot be undone.",
+		"pickWinner": "Pick Winner",
+		"pickWinnerMessage": "Pick <bold>{{name}}</bold> as the winner? This will add it to your collection and archive the thread."
+	},
+	"externalLink": {
+		"title": "You are about to leave GearBox",
+		"redirectMessage": "You will be redirected to:"
+	},
+	"fab": {
+		"addToCollection": "Add to Collection",
+		"startNewThread": "Start New Thread",
+		"newSetup": "New Setup"
+	},
+	"empty": {
+		"noResults": "No results found",
+		"noItems": "No items match your search"
+	},
+	"stats": {
+		"items": "Items",
+		"totalWeight": "Total Weight",
+		"totalSpent": "Total Spent"
+	},
+	"filter": {
+		"showing": "Showing {{filtered}} of {{total}} items",
+		"searchItems": "Search items...",
+		"allCategories": "All Categories"
+	}
+}

src/client/locales/en/onboarding.json

@@ -0,0 +1,34 @@
+{
+	"welcome": {
+		"title": "Welcome to GearBox",
+		"subtitle": "Tell us what you're into, and we'll help you set up your collection with gear that people actually use.",
+		"cta": "Let's go"
+	},
+	"hobby": {
+		"title": "What are you into?",
+		"subtitle": "Pick one or more — we'll show you popular gear for each.",
+		"continue": "Continue"
+	},
+	"items": {
+		"title": "Popular gear for {{hobby}}",
+		"titleMultiple": "Popular gear for your hobbies",
+		"subtitle": "Tap items you already own. We'll add them to your collection.",
+		"noCatalog": "No gear cataloged yet",
+		"noCatalogDescription": "We're still building our catalog for this hobby. You can skip this step and add gear manually later.",
+		"reviewCount": "Review {{count}} items",
+		"reviewCount_one": "Review {{count}} item"
+	},
+	"review": {
+		"title": "Your starting collection",
+		"itemsReady": "{{count}} items ready to add",
+		"itemsReady_one": "{{count}} item ready to add",
+		"noItemsSelected": "No items selected — you can always add gear later from the catalog.",
+		"addToCollection": "Add to my collection",
+		"adding": "Adding..."
+	},
+	"done": {
+		"title": "You're all set!",
+		"subtitle": "Your collection is ready. Browse the catalog anytime to discover more gear.",
+		"cta": "Start exploring"
+	}
+}

src/client/locales/en/settings.json

@@ -0,0 +1,32 @@
+{
+	"title": "Settings",
+	"language": {
+		"title": "Language",
+		"description": "Change the display language of the app"
+	},
+	"weightUnit": {
+		"title": "Weight Unit",
+		"description": "Choose the unit used to display weights across the app"
+	},
+	"currency": {
+		"title": "Currency",
+		"description": "Changes the currency symbol displayed. This does not convert values."
+	},
+	"apiKeys": {
+		"title": "API Keys",
+		"description": "API keys allow programmatic access to GearBox (e.g., from Claude Desktop or scripts).",
+		"copyWarning": "Copy this key now — it won't be shown again:",
+		"namePlaceholder": "Key name (e.g., claude-desktop)"
+	},
+	"importExport": {
+		"title": "Import / Export",
+		"description": "Export your gear collection as a CSV file, or import items from a CSV.",
+		"export": "Export CSV",
+		"import": "Import CSV",
+		"importing": "Importing...",
+		"imported": "{{count}} items imported.",
+		"imported_one": "{{count}} item imported.",
+		"newCategories": "New categories: {{categories}}",
+		"noItemsFound": "No items found in the CSV."
+	}
+}

src/client/locales/en/setups.json

@@ -0,0 +1,43 @@
+{
+	"title": "Setups",
+	"create": "New Setup",
+	"empty": {
+		"title": "No setups yet",
+		"description": "Create a setup to organize gear for specific trips or activities."
+	},
+	"card": {
+		"items": "{{count}} items",
+		"items_one": "{{count}} item",
+		"weight": "Weight",
+		"price": "Price"
+	},
+	"share": {
+		"title": "Share Setup",
+		"shareLinks": "Share Links",
+		"createLink": "Create Link",
+		"noLinks": "No share links yet",
+		"copyLink": "Copy link",
+		"revokeLink": "Revoke link",
+		"copied": "Copied!",
+		"noExpiration": "No expiration",
+		"expired": "Expired",
+		"expiresToday": "Expires today",
+		"expiresTomorrow": "Expires tomorrow",
+		"expiresInDays": "Expires in {{days}} days",
+		"daysOption": "{{days}} days",
+		"deactivateWarning": "Switching to private will deactivate all share links. They can be reactivated by switching back."
+	},
+	"visibility": {
+		"private": "Private",
+		"privateDescription": "Only you can access",
+		"link": "Link sharing",
+		"linkDescription": "Anyone with the link",
+		"public": "Public",
+		"publicDescription": "Visible on your profile"
+	},
+	"impact": {
+		"title": "Impact Preview",
+		"adding": "Adding",
+		"removing": "Removing"
+	}
+}

src/client/locales/en/threads.json

@@ -0,0 +1,45 @@
+{
+	"title": "Research Threads",
+	"create": {
+		"title": "New Thread",
+		"threadName": "Thread name",
+		"namePlaceholder": "e.g. Lightweight sleeping bag",
+		"category": "Category",
+		"nameRequired": "Thread name is required",
+		"selectCategory": "Please select a category",
+		"createFailed": "Failed to create thread",
+		"createThread": "Create Thread"
+	},
+	"status": {
+		"active": "Active",
+		"researching": "Researching",
+		"ordered": "Ordered",
+		"arrived": "Arrived",
+		"resolved": "Resolved",
+		"archived": "Archived"
+	},
+	"candidate": {
+		"name": "Name",
+		"price": "Price",
+		"weight": "Weight",
+		"url": "URL",
+		"pros": "Pros",
+		"cons": "Cons",
+		"notes": "Notes",
+		"addCandidate": "Add Candidate"
+	},
+	"comparison": {
+		"weight": "Weight",
+		"price": "Price",
+		"pros": "Pros",
+		"cons": "Cons"
+	},
+	"resolve": {
+		"title": "Pick Winner",
+		"message": "Pick <bold>{{name}}</bold> as the winner? This will add it to your collection and archive the thread."
+	},
+	"empty": {
+		"noThreads": "No research threads yet",
+		"noCandidates": "No candidates yet"
+	}
+}

src/client/main.tsx

@@ -1,3 +1,4 @@
+import "./lib/i18n";
 import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
 import { createRouter, RouterProvider } from "@tanstack/react-router";
 import { StrictMode } from "react";

src/client/routes/__root.tsx

@@ -7,7 +7,8 @@ import {
 	useNavigate,
 	useRouter,
 } from "@tanstack/react-router";
-import { useState } from "react";
+import { useEffect, useState } from "react";
+import { useTranslation } from "react-i18next";
 import { Toaster } from "sonner";
 import "../app.css";
 import { AddToCollectionModal } from "../components/AddToCollectionModal";
@@ -22,6 +23,7 @@ import { OnboardingFlow } from "../components/onboarding/OnboardingFlow";
 import { TopNav } from "../components/TopNav";
 import { useAuth } from "../hooks/useAuth";
 import { useDeleteCandidate } from "../hooks/useCandidates";
+import { useLanguage } from "../hooks/useLanguage";
 import { useOnboardingComplete } from "../hooks/useSettings";
 import { useResolveThread, useThread } from "../hooks/useThreads";
 import { useUIStore } from "../stores/uiStore";
@@ -33,6 +35,7 @@ export const Route = createRootRoute({
 
 function RootErrorBoundary({ error, reset }: ErrorComponentProps) {
 	const router = useRouter();
+	const { t } = useTranslation();
 
 	return (
 		<div className="min-h-screen bg-gray-50 flex items-center justify-center">
@@ -53,12 +56,10 @@ function RootErrorBoundary({ error, reset }: ErrorComponentProps) {
 					</svg>
 				</div>
 				<h1 className="text-xl font-semibold text-gray-900 mb-2">
-					Something went wrong
+					{t("errors.somethingWentWrong")}
 				</h1>
 				<p className="text-sm text-gray-500 mb-6">
-					{error instanceof Error
-						? error.message
-						: "An unexpected error occurred"}
+					{error instanceof Error ? error.message : t("errors.unexpectedError")}
 				</p>
 				<button
 					type="button"
@@ -68,7 +69,7 @@ function RootErrorBoundary({ error, reset }: ErrorComponentProps) {
 					}}
 					className="px-5 py-2.5 bg-gray-700 hover:bg-gray-800 text-white text-sm font-medium rounded-lg transition-colors"
 				>
-					Try again
+					{t("actions.tryAgain")}
 				</button>
 			</div>
 		</div>
@@ -80,6 +81,15 @@ function RootLayout() {
 	const location = useLocation();
 	const { data: auth, isLoading: authLoading } = useAuth();
 	const isAuthenticated = !!auth?.user;
+	const language = useLanguage();
+	const { i18n } = useTranslation();
+
+	// Sync i18n language with persisted setting
+	useEffect(() => {
+		if (language && i18n.language !== language) {
+			i18n.changeLanguage(language);
+		}
+	}, [language, i18n]);
 
 	// Candidate delete state
 	const confirmDeleteCandidateId = useUIStore(
@@ -205,6 +215,7 @@ function CandidateDeleteDialog({
 	threadId: number;
 	onClose: () => void;
 }) {
+	const { t } = useTranslation();
 	const deleteCandidate = useDeleteCandidate(threadId);
 	const { data: thread } = useThread(threadId);
 	const candidate = thread?.candidates.find((c) => c.id === candidateId);
@@ -227,12 +238,10 @@ function CandidateDeleteDialog({
 			/>
 			<div className="relative bg-white rounded-xl shadow-lg p-6 max-w-sm mx-4 w-full">
 				<h3 className="text-lg font-semibold text-gray-900 mb-2">
-					Delete Candidate
+					{t("confirm.deleteCandidate")}
 				</h3>
 				<p className="text-sm text-gray-600 mb-6">
-					Are you sure you want to delete{" "}
-					<span className="font-medium">{candidateName}</span>? This action
-					cannot be undone.
+					{t("confirm.deleteCandidateMessage", { name: candidateName })}
 				</p>
 				<div className="flex justify-end gap-3">
 					<button
@@ -240,7 +249,7 @@ function CandidateDeleteDialog({
 						onClick={onClose}
 						className="px-4 py-2 text-sm font-medium text-gray-700 bg-gray-100 hover:bg-gray-200 rounded-lg transition-colors"
 					>
-						Cancel
+						{t("actions.cancel")}
 					</button>
 					<button
 						type="button"
@@ -248,7 +257,9 @@ function CandidateDeleteDialog({
 						disabled={deleteCandidate.isPending}
 						className="px-4 py-2 text-sm font-medium text-white bg-red-600 hover:bg-red-700 disabled:opacity-50 rounded-lg transition-colors"
 					>
-						{deleteCandidate.isPending ? "Deleting..." : "Delete"}
+						{deleteCandidate.isPending
+							? t("actions.deleting")
+							: t("actions.delete")}
 					</button>
 				</div>
 			</div>
@@ -267,6 +278,7 @@ function ResolveDialog({
 	onClose: () => void;
 	onResolved: () => void;
 }) {
+	const { t } = useTranslation();
 	const resolveThread = useResolveThread();
 	const { data: thread } = useThread(threadId);
 	const candidate = thread?.candidates.find((c) => c.id === candidateId);
@@ -290,11 +302,10 @@ function ResolveDialog({
 			/>
 			<div className="relative bg-white rounded-xl shadow-lg p-6 max-w-sm mx-4 w-full">
 				<h3 className="text-lg font-semibold text-gray-900 mb-2">
-					Pick Winner
+					{t("confirm.pickWinner")}
 				</h3>
 				<p className="text-sm text-gray-600 mb-6">
-					Pick <span className="font-medium">{candidateName}</span> as the
-					winner? This will add it to your collection and archive the thread.
+					{t("confirm.pickWinnerMessage", { name: candidateName })}
 				</p>
 				<div className="flex justify-end gap-3">
 					<button
@@ -302,7 +313,7 @@ function ResolveDialog({
 						onClick={onClose}
 						className="px-4 py-2 text-sm font-medium text-gray-700 bg-gray-100 hover:bg-gray-200 rounded-lg transition-colors"
 					>
-						Cancel
+						{t("actions.cancel")}
 					</button>
 					<button
 						type="button"
@@ -310,7 +321,9 @@ function ResolveDialog({
 						disabled={resolveThread.isPending}
 						className="px-4 py-2 text-sm font-medium text-white bg-amber-600 hover:bg-amber-700 disabled:opacity-50 rounded-lg transition-colors"
 					>
-						{resolveThread.isPending ? "Resolving..." : "Pick Winner"}
+						{resolveThread.isPending
+							? t("actions.saving")
+							: t("confirm.pickWinner")}
 					</button>
 				</div>
 			</div>

src/client/routes/global-items/$globalItemId.tsx

@@ -1,8 +1,15 @@
 import { createFileRoute, Link } from "@tanstack/react-router";
+import { useState } from "react";
 import { GearImage, imageContainerBg } from "../../components/GearImage";
 import { useAuth } from "../../hooks/useAuth";
+import { useCurrency } from "../../hooks/useCurrency";
 import { useFormatters } from "../../hooks/useFormatters";
-import { useGlobalItem } from "../../hooks/useGlobalItems";
+import {
+	useGlobalItem,
+	useGlobalItemCommunityStats,
+	useGlobalItemPrices,
+} from "../../hooks/useGlobalItems";
+import { type Currency, formatPrice } from "../../lib/formatters";
 import { LucideIcon } from "../../lib/iconData";
 import { useUIStore } from "../../stores/uiStore";
 
@@ -235,6 +242,9 @@ function GlobalItemDetail() {
 				</div>
 			)}
 
+			{/* Market Prices Section */}
+			<MarketPricesSection globalItemId={Number(globalItemId)} />
+
 			{/* Product page link */}
 			{item.sourceUrl && (
 				<div className="mt-4">
@@ -251,3 +261,100 @@ function GlobalItemDetail() {
 		</div>
 	);
 }
+
+function MarketPricesSection({ globalItemId }: { globalItemId: number }) {
+	const { market: userMarket } = useCurrency();
+	const { data: pricesData } = useGlobalItemPrices(globalItemId);
+	const { data: communityStats } = useGlobalItemCommunityStats(globalItemId);
+	const [showOtherMarkets, setShowOtherMarkets] = useState(false);
+
+	const marketPrices = pricesData?.marketPrices ?? [];
+	const stats = communityStats ?? [];
+
+	// No data at all — don't render section
+	if (marketPrices.length === 0 && stats.length === 0) return null;
+
+	const userMarketPrice = marketPrices.find((p) => p.market === userMarket);
+	const otherMarketPrices = marketPrices.filter((p) => p.market !== userMarket);
+	const userMarketStats = stats.filter((s) => s.market === userMarket);
+	const otherMarketStats = stats.filter((s) => s.market !== userMarket);
+
+	return (
+		<div className="mt-6 mb-6">
+			<h3 className="text-sm font-medium text-gray-900 mb-3">Price</h3>
+
+			{/* User's market MSRP */}
+			{userMarketPrice && (
+				<div className="mb-2">
+					<span className="text-lg font-semibold text-gray-900">
+						{formatPrice(
+							userMarketPrice.priceCents,
+							userMarketPrice.currency as Currency,
+						)}
+					</span>
+					<span className="text-xs text-gray-500 ml-2">
+						MSRP ({userMarketPrice.market})
+					</span>
+				</div>
+			)}
+
+			{/* Community stats for user's market */}
+			{userMarketStats.map((stat) => (
+				<p
+					key={`${stat.market}-${stat.currency}`}
+					className="text-sm text-gray-700 mb-1"
+				>
+					Community ({stat.market}):{" "}
+					{formatPrice(stat.medianPrice, stat.currency as Currency)} median{" "}
+					<span className="text-xs text-gray-400">
+						({stat.reportCount} reports)
+					</span>
+				</p>
+			))}
+
+			{/* Other Markets collapsible */}
+			{(otherMarketPrices.length > 0 || otherMarketStats.length > 0) && (
+				<div className="mt-3">
+					<button
+						type="button"
+						onClick={() => setShowOtherMarkets(!showOtherMarkets)}
+						className="text-sm text-gray-500 cursor-pointer hover:text-gray-700 flex items-center gap-1"
+					>
+						<LucideIcon
+							name={showOtherMarkets ? "chevron-down" : "chevron-right"}
+							size={14}
+						/>
+						Other Markets
+					</button>
+					{showOtherMarkets && (
+						<div className="pl-4 mt-2 space-y-1">
+							{otherMarketPrices.map((p) => (
+								<div key={`${p.market}-${p.currency}`}>
+									<span className="text-sm font-medium text-gray-900">
+										{formatPrice(p.priceCents, p.currency as Currency)}
+									</span>
+									<span className="text-xs text-gray-500 ml-2">
+										MSRP ({p.market})
+									</span>
+								</div>
+							))}
+							{otherMarketStats.map((stat) => (
+								<p
+									key={`${stat.market}-${stat.currency}`}
+									className="text-sm text-gray-700"
+								>
+									Community ({stat.market}):{" "}
+									{formatPrice(stat.medianPrice, stat.currency as Currency)}{" "}
+									median{" "}
+									<span className="text-xs text-gray-400">
+										({stat.reportCount} reports)
+									</span>
+								</p>
+							))}
+						</div>
+					)}
+				</div>
+			)}
+		</div>
+	);
+}

src/client/routes/items/$itemId.tsx

@@ -1,16 +1,25 @@
 import { createFileRoute, Link, useNavigate } from "@tanstack/react-router";
 import { useState } from "react";
+import { z } from "zod";
 import { CategoryPicker } from "../../components/CategoryPicker";
 import { GearImage, imageContainerBg } from "../../components/GearImage";
 import { ImageCropEditor } from "../../components/ImageCropEditor";
 import { ImageUpload } from "../../components/ImageUpload";
+import { useAuth } from "../../hooks/useAuth";
 import { useFormatters } from "../../hooks/useFormatters";
 import { useDuplicateItem, useItem, useUpdateItem } from "../../hooks/useItems";
+import { usePublicSetupItem, useSharedSetupItem } from "../../hooks/useSetups";
 import { LucideIcon } from "../../lib/iconData";
 import { useUIStore } from "../../stores/uiStore";
 
+const itemSearchSchema = z.object({
+	setup: z.number().optional().catch(undefined),
+	share: z.string().optional().catch(undefined),
+});
+
 export const Route = createFileRoute("/items/$itemId")({
 	component: ItemDetail,
+	validateSearch: itemSearchSchema,
 });
 
 interface EditFormState {
@@ -27,18 +36,47 @@ interface EditFormState {
 
 function ItemDetail() {
 	const { itemId } = Route.useParams();
+	const { setup: setupId, share: shareToken } = Route.useSearch();
 	const navigate = useNavigate();
-	const {
-		data: item,
-		isLoading,
-		error,
-	} = useItem(Number(itemId)) as ReturnType<typeof useItem> & {
+	const { data: auth } = useAuth();
+	const isAuthenticated = !!auth?.user;
+
+	// Determine access mode: shared (token), public (setup context, no auth), or owner
+	const isSharedAccess = !!shareToken;
+	const isPublicAccess = !isSharedAccess && !!setupId && !isAuthenticated;
+	const isOwnerAccess = !isSharedAccess && !isPublicAccess;
+
+	// Fetch item based on access mode
+	const ownerQuery = useItem(
+		isOwnerAccess ? Number(itemId) : null,
+	) as ReturnType<typeof useItem> & {
 		data:
 			| (NonNullable<ReturnType<typeof useItem>["data"]> & {
 					imageUrl?: string | null;
 			  })
 			| undefined;
 	};
+	const sharedQuery = useSharedSetupItem(
+		isSharedAccess ? shareToken : null,
+		isSharedAccess ? Number(itemId) : null,
+	);
+	const publicQuery = usePublicSetupItem(
+		isPublicAccess ? (setupId ?? null) : null,
+		isPublicAccess ? Number(itemId) : null,
+	);
+
+	const activeQuery = isSharedAccess
+		? sharedQuery
+		: isPublicAccess
+			? publicQuery
+			: ownerQuery;
+
+	const item = activeQuery.data as typeof ownerQuery.data;
+	const isLoading = activeQuery.isLoading;
+	const error = activeQuery.error;
+
+	const isReadOnly = isSharedAccess || isPublicAccess;
+
 	const { weight, price } = useFormatters();
 	const updateItem = useUpdateItem();
 	const duplicateItem = useDuplicateItem();
@@ -157,14 +195,26 @@ function ItemDetail() {
 		);
 	}
 
+	// Back link: return to setup if accessed from setup context, else collection
+	const backLink = setupId
+		? {
+				to: "/setups/$setupId" as const,
+				params: { setupId: String(setupId) },
+				search: shareToken ? { share: shareToken } : {},
+			}
+		: { to: "/collection" as const, params: {}, search: {} };
+	const backLabel = setupId ? "Back to setup" : "Back to collection";
+
 	if (error || !item) {
 		return (
 			<div className="max-w-3xl mx-auto px-4 sm:px-6 lg:px-8 py-6">
 				<Link
-					to="/collection"
+					to={backLink.to}
+					params={backLink.params}
+					search={backLink.search}
 					className="text-sm text-gray-400 hover:text-gray-600 transition-colors"
 				>
-					&larr; Back to collection
+					&larr; {backLabel}
 				</Link>
 				<div className="text-center py-16">
 					<p className="text-sm text-gray-500">Item not found</p>
@@ -181,12 +231,14 @@ function ItemDetail() {
 			{/* Top bar */}
 			<div className="flex items-center justify-between mb-6">
 				<Link
-					to="/collection"
+					to={backLink.to}
+					params={backLink.params}
+					search={backLink.search}
 					className="text-sm text-gray-400 hover:text-gray-600 transition-colors"
 				>
-					&larr; Back to collection
+					&larr; {backLabel}
 				</Link>
-				{!isEditing && (
+				{!isEditing && !isReadOnly && (
 					<div className="flex items-center gap-2">
 						{/* Duplicate — desktop */}
 						<button

src/client/routes/login.tsx

@@ -1,5 +1,6 @@
 import { createFileRoute, useNavigate } from "@tanstack/react-router";
 import { useEffect } from "react";
+import { useTranslation } from "react-i18next";
 import { useAuth } from "../hooks/useAuth";
 
 export const Route = createFileRoute("/login")({
@@ -7,6 +8,7 @@ export const Route = createFileRoute("/login")({
 });
 
 function LoginPage() {
+	const { t } = useTranslation();
 	const navigate = useNavigate();
 	const { data: auth, isLoading } = useAuth();
 
@@ -19,7 +21,7 @@ function LoginPage() {
 	if (isLoading) {
 		return (
 			<div className="min-h-screen bg-gray-50 flex items-center justify-center">
-				<p className="text-gray-500 text-sm">Loading...</p>
+				<p className="text-gray-500 text-sm">{t("actions.loading")}</p>
 			</div>
 		);
 	}
@@ -28,11 +30,11 @@ function LoginPage() {
 		<div className="min-h-screen bg-gray-50 flex items-center justify-center px-4">
 			<div className="w-full max-w-sm">
 				<h1 className="text-xl font-semibold text-gray-900 text-center mb-6">
-					Sign in to GearBox
+					{t("auth.signInToGearBox")}
 				</h1>
 				<div className="bg-white rounded-xl border border-gray-100 p-6 space-y-4">
 					<p className="text-sm text-gray-500 text-center">
-						You will be redirected to sign in with your account.
+						{t("auth.redirectDescription")}
 					</p>
 					<button
 						type="button"
@@ -41,7 +43,7 @@ function LoginPage() {
 						}}
 						className="w-full py-2 px-4 text-sm font-medium text-white bg-gray-700 hover:bg-gray-800 rounded-lg transition-colors"
 					>
-						Sign In
+						{t("auth.signIn")}
 					</button>
 				</div>
 			</div>

src/client/routes/settings.tsx

@@ -1,5 +1,6 @@
 import { createFileRoute, Link } from "@tanstack/react-router";
 import { useRef, useState } from "react";
+import { useTranslation } from "react-i18next";
 import {
 	useApiKeys,
 	useAuth,
@@ -8,9 +9,16 @@ import {
 } from "../hooks/useAuth";
 import { useCurrency } from "../hooks/useCurrency";
 import { useExportItems, useImportItems } from "../hooks/useItems";
+import { useLanguage } from "../hooks/useLanguage";
 import { useUpdateSetting } from "../hooks/useSettings";
 import { useWeightUnit } from "../hooks/useWeightUnit";
 import type { Currency, WeightUnit } from "../lib/formatters";
+import i18n from "../lib/i18n";
+
+const LANGUAGES = [
+	{ value: "en", label: "English" },
+	{ value: "de", label: "Deutsch" },
+];
 
 const UNITS: WeightUnit[] = ["g", "oz", "lb", "kg"];
 const CURRENCIES: { value: Currency; label: string }[] = [
@@ -27,6 +35,7 @@ export const Route = createFileRoute("/settings")({
 });
 
 function ApiKeySection() {
+	const { t } = useTranslation("settings");
 	const { data: keys } = useApiKeys();
 	const createKey = useCreateApiKey();
 	const deleteKey = useDeleteApiKey();
@@ -42,16 +51,15 @@ function ApiKeySection() {
 
 	return (
 		<div className="space-y-3">
-			<h3 className="text-sm font-medium text-gray-900">API Keys</h3>
-			<p className="text-xs text-gray-500">
-				API keys allow programmatic access to GearBox (e.g., from Claude Desktop
-				or scripts).
-			</p>
+			<h3 className="text-sm font-medium text-gray-900">
+				{t("apiKeys.title")}
+			</h3>
+			<p className="text-xs text-gray-500">{t("apiKeys.description")}</p>
 
 			{newKey && (
 				<div className="bg-amber-50 border border-amber-200 rounded-lg p-3">
 					<p className="text-xs font-medium text-amber-800 mb-1">
-						Copy this key now — it won't be shown again:
+						{t("apiKeys.copyWarning")}
 					</p>
 					<code className="text-xs text-amber-900 break-all select-all">
 						{newKey}
@@ -61,7 +69,7 @@ function ApiKeySection() {
 						onClick={() => setNewKey(null)}
 						className="mt-2 block text-xs text-amber-700 hover:text-amber-900"
 					>
-						Dismiss
+						{t("common:actions.dismiss")}
 					</button>
 				</div>
 			)}
@@ -69,7 +77,7 @@ function ApiKeySection() {
 			<form onSubmit={handleCreate} className="flex gap-2">
 				<input
 					type="text"
-					placeholder="Key name (e.g., claude-desktop)"
+					placeholder={t("apiKeys.namePlaceholder")}
 					value={name}
 					onChange={(e) => setName(e.target.value)}
 					required
@@ -80,7 +88,7 @@ function ApiKeySection() {
 					disabled={createKey.isPending}
 					className="px-4 py-2 text-sm font-medium text-white bg-gray-700 hover:bg-gray-800 disabled:opacity-50 rounded-lg transition-colors"
 				>
-					Create
+					{t("common:actions.create")}
 				</button>
 			</form>
 
@@ -102,7 +110,7 @@ function ApiKeySection() {
 								onClick={() => deleteKey.mutate(key.id)}
 								className="text-xs text-red-500 hover:text-red-700"
 							>
-								Revoke
+								{t("common:actions.revoke")}
 							</button>
 						</div>
 					))}
@@ -113,6 +121,7 @@ function ApiKeySection() {
 }
 
 function ImportExportSection() {
+	const { t } = useTranslation("settings");
 	const exportItems = useExportItems();
 	const importItems = useImportItems();
 	const fileInputRef = useRef<HTMLInputElement>(null);
@@ -142,10 +151,10 @@ function ImportExportSection() {
 
 	return (
 		<div className="space-y-3">
-			<h3 className="text-sm font-medium text-gray-900">Import / Export</h3>
-			<p className="text-xs text-gray-500">
-				Export your gear collection as a CSV file, or import items from a CSV.
-			</p>
+			<h3 className="text-sm font-medium text-gray-900">
+				{t("importExport.title")}
+			</h3>
+			<p className="text-xs text-gray-500">{t("importExport.description")}</p>
 
 			<div className="flex flex-wrap gap-2">
 				<button
@@ -153,11 +162,13 @@ function ImportExportSection() {
 					onClick={exportItems}
 					className="px-4 py-2 text-sm font-medium text-white bg-gray-700 hover:bg-gray-800 rounded-lg transition-colors"
 				>
-					Export CSV
+					{t("importExport.export")}
 				</button>
 
 				<label className="px-4 py-2 text-sm font-medium text-gray-700 bg-white border border-gray-200 hover:bg-gray-50 rounded-lg transition-colors cursor-pointer">
-					{importItems.isPending ? "Importing..." : "Import CSV"}
+					{importItems.isPending
+						? t("importExport.importing")
+						: t("importExport.import")}
 					<input
 						ref={fileInputRef}
 						type="file"
@@ -179,12 +190,15 @@ function ImportExportSection() {
 				>
 					{importResult.imported > 0 && (
 						<p className="font-medium">
-							{importResult.imported} item
-							{importResult.imported !== 1 ? "s" : ""} imported.
+							{t("importExport.imported", { count: importResult.imported })}
 						</p>
 					)}
 					{importResult.createdCategories.length > 0 && (
-						<p>New categories: {importResult.createdCategories.join(", ")}</p>
+						<p>
+							{t("importExport.newCategories", {
+								categories: importResult.createdCategories.join(", "),
+							})}
+						</p>
 					)}
 					{importResult.errors.map((err, i) => (
 						// biome-ignore lint/suspicious/noArrayIndexKey: static error list
@@ -193,7 +207,7 @@ function ImportExportSection() {
 						</p>
 					))}
 					{importResult.imported === 0 && importResult.errors.length === 0 && (
-						<p>No items found in the CSV.</p>
+						<p>{t("importExport.noItemsFound")}</p>
 					)}
 				</div>
 			)}
@@ -201,11 +215,44 @@ function ImportExportSection() {
 	);
 }
 
+const LOCALE_CURRENCY_MAP: Record<string, Currency> = {
+	de: "EUR",
+	fr: "EUR",
+	es: "EUR",
+	it: "EUR",
+	nl: "EUR",
+	pt: "EUR",
+	en: "USD",
+	ja: "JPY",
+};
+
+function getSuggestedCurrency(): Currency | null {
+	try {
+		const lang = navigator.language;
+		// Check full locale first (e.g., en-GB → GBP)
+		if (lang.startsWith("en-GB")) return "GBP";
+		if (lang.startsWith("en-AU")) return "AUD";
+		if (lang.startsWith("en-CA") || lang.startsWith("fr-CA")) return "CAD";
+		// Fall back to language prefix
+		const prefix = lang.split("-")[0];
+		return LOCALE_CURRENCY_MAP[prefix] ?? null;
+	} catch {
+		return null;
+	}
+}
+
 function SettingsPage() {
+	const { t } = useTranslation("settings");
 	const unit = useWeightUnit();
-	const currency = useCurrency();
+	const language = useLanguage();
+	const { currency, showConversions } = useCurrency();
 	const updateSetting = useUpdateSetting();
 	const { data: auth } = useAuth();
+	const [suggestionDismissed, setSuggestionDismissed] = useState(false);
+
+	const suggestedCurrency = getSuggestedCurrency();
+	const showSuggestion =
+		!suggestionDismissed && suggestedCurrency && suggestedCurrency !== currency;
 
 	return (
 		<div className="max-w-2xl mx-auto px-4 sm:px-6 lg:px-8 py-6">
@@ -214,17 +261,77 @@ function SettingsPage() {
 					to="/"
 					className="text-sm text-gray-500 hover:text-gray-700 mb-2 inline-block"
 				>
-					&larr; Back
+					&larr; {t("common:actions.back")}
 				</Link>
-				<h1 className="text-xl font-semibold text-gray-900">Settings</h1>
+				<h1 className="text-xl font-semibold text-gray-900">{t("title")}</h1>
 			</div>
 
+			{showSuggestion && (
+				<div className="bg-blue-50 border border-blue-100 rounded-xl px-4 py-3 mb-4 flex items-center justify-between">
+					<span className="text-sm text-blue-700">
+						Based on your location, we suggest{" "}
+						{CURRENCIES.find((c) => c.value === suggestedCurrency)?.label ??
+							suggestedCurrency}{" "}
+						({suggestedCurrency})
+					</span>
+					<button
+						type="button"
+						onClick={() => {
+							updateSetting.mutate({
+								key: "currency",
+								value: suggestedCurrency,
+							});
+							setSuggestionDismissed(true);
+						}}
+						className="text-sm font-medium text-blue-700 hover:text-blue-800 underline ml-3"
+					>
+						Use{" "}
+						{CURRENCIES.find((c) => c.value === suggestedCurrency)?.label ??
+							suggestedCurrency}
+					</button>
+				</div>
+			)}
+
 			<div className="bg-white rounded-xl border border-gray-100 p-5 space-y-6">
 				<div className="flex items-center justify-between">
 					<div>
-						<h3 className="text-sm font-medium text-gray-900">Weight Unit</h3>
+						<h3 className="text-sm font-medium text-gray-900">
+							{t("language.title")}
+						</h3>
 						<p className="text-xs text-gray-500 mt-0.5">
-							Choose the unit used to display weights across the app
+							{t("language.description")}
+						</p>
+					</div>
+					<div className="flex items-center gap-1 bg-gray-100 rounded-full px-1 py-0.5">
+						{LANGUAGES.map((lang) => (
+							<button
+								key={lang.value}
+								type="button"
+								onClick={() => {
+									updateSetting.mutate({ key: "language", value: lang.value });
+									i18n.changeLanguage(lang.value);
+								}}
+								className={`px-2.5 py-1 text-xs rounded-full transition-colors ${
+									language === lang.value
+										? "bg-white text-gray-700 shadow-sm font-medium"
+										: "text-gray-400 hover:text-gray-600"
+								}`}
+							>
+								{lang.label}
+							</button>
+						))}
+					</div>
+				</div>
+
+				<div className="border-t border-gray-100" />
+
+				<div className="flex items-center justify-between">
+					<div>
+						<h3 className="text-sm font-medium text-gray-900">
+							{t("weightUnit.title")}
+						</h3>
+						<p className="text-xs text-gray-500 mt-0.5">
+							{t("weightUnit.description")}
 						</p>
 					</div>
 					<div className="flex items-center gap-1 bg-gray-100 rounded-full px-1 py-0.5">
@@ -254,10 +361,11 @@ function SettingsPage() {
 
 				<div className="flex items-center justify-between">
 					<div>
-						<h3 className="text-sm font-medium text-gray-900">Currency</h3>
+						<h3 className="text-sm font-medium text-gray-900">
+							{t("currency.title")}
+						</h3>
 						<p className="text-xs text-gray-500 mt-0.5">
-							Changes the currency symbol displayed. This does not convert
-							values.
+							{t("currency.description")}
 						</p>
 					</div>
 					<div className="flex items-center gap-1 bg-gray-100 rounded-full px-1 py-0.5">
@@ -282,6 +390,37 @@ function SettingsPage() {
 						))}
 					</div>
 				</div>
+
+				<div className="border-t border-gray-100" />
+
+				<div className="flex items-center justify-between">
+					<div>
+						<h3 className="text-sm font-medium text-gray-900">
+							Show Converted Prices
+						</h3>
+						<p className="text-xs text-gray-500 mt-0.5">
+							Display approximate conversions when local price is not available
+						</p>
+					</div>
+					<button
+						type="button"
+						onClick={() =>
+							updateSetting.mutate({
+								key: "showConversions",
+								value: showConversions ? "false" : "true",
+							})
+						}
+						className={`relative w-10 h-5 rounded-full transition-colors ${
+							showConversions ? "bg-blue-500" : "bg-gray-200"
+						}`}
+					>
+						<span
+							className={`absolute top-0.5 left-0.5 w-4 h-4 rounded-full bg-white shadow-sm transition-transform ${
+								showConversions ? "translate-x-5" : "translate-x-0"
+							}`}
+						/>
+					</button>
+				</div>
 			</div>
 
 			<div className="bg-white rounded-xl border border-gray-100 p-5 space-y-6 mt-4">

src/client/routes/setups/$setupId.tsx

@@ -1,8 +1,10 @@
 import { createFileRoute, Link, useNavigate } from "@tanstack/react-router";
 import { useState } from "react";
+import { z } from "zod";
 import { CategoryHeader } from "../../components/CategoryHeader";
 import { ItemCard } from "../../components/ItemCard";
 import { ItemPicker } from "../../components/ItemPicker";
+import { ShareModal } from "../../components/ShareModal";
 import { WeightSummaryCard } from "../../components/WeightSummaryCard";
 import { useAuth } from "../../hooks/useAuth";
 import { useFormatters } from "../../hooks/useFormatters";
@@ -11,6 +13,7 @@ import {
 	usePublicSetup,
 	useRemoveSetupItem,
 	useSetup,
+	useSharedSetup,
 	useUpdateItemClassification,
 	useUpdateSetup,
 } from "../../hooks/useSetups";
@@ -18,22 +21,35 @@ import { LucideIcon } from "../../lib/iconData";
 
 export const Route = createFileRoute("/setups/$setupId")({
 	component: SetupDetailPage,
+	validateSearch: z.object({
+		share: z.string().optional(),
+	}),
 });
 
 function SetupDetailPage() {
 	const { setupId } = Route.useParams();
+	const { share: shareToken } = Route.useSearch();
 	const { weight, price } = useFormatters();
 	const navigate = useNavigate();
 	const numericId = Number(setupId);
 
 	const { data: auth } = useAuth();
 	const isAuthenticated = !!auth?.user;
+	const isSharedView = !!shareToken;
 
-	const privateSetup = useSetup(isAuthenticated ? numericId : null);
-	const publicSetup = usePublicSetup(!isAuthenticated ? numericId : null);
-	const { data: setup, isLoading } = isAuthenticated
-		? privateSetup
-		: publicSetup;
+	// Priority: share token > authenticated owner > public viewer
+	const sharedSetup = useSharedSetup(shareToken ?? null);
+	const privateSetup = useSetup(
+		!isSharedView && isAuthenticated ? numericId : null,
+	);
+	const publicSetup = usePublicSetup(
+		!isSharedView && !isAuthenticated ? numericId : null,
+	);
+	const {
+		data: setup,
+		isLoading,
+		isError: isSharedError,
+	} = isSharedView ? sharedSetup : isAuthenticated ? privateSetup : publicSetup;
 
 	const deleteSetup = useDeleteSetup();
 	const updateSetup = useUpdateSetup(numericId);
@@ -42,6 +58,7 @@ function SetupDetailPage() {
 
 	const [pickerOpen, setPickerOpen] = useState(false);
 	const [confirmDelete, setConfirmDelete] = useState(false);
+	const [shareModalOpen, setShareModalOpen] = useState(false);
 
 	if (isLoading) {
 		return (
@@ -58,6 +75,24 @@ function SetupDetailPage() {
 		);
 	}
 
+	if (isSharedView && isSharedError) {
+		return (
+			<div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12 text-center">
+				<LucideIcon
+					name="link"
+					size={48}
+					className="text-gray-300 mx-auto mb-4"
+				/>
+				<h2 className="text-xl font-semibold text-gray-900 mb-2">
+					Link not available
+				</h2>
+				<p className="text-sm text-gray-500">
+					This share link has expired or is no longer valid.
+				</p>
+			</div>
+		);
+	}
+
 	if (!setup) {
 		return (
 			<div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-16 text-center">
@@ -113,8 +148,18 @@ function SetupDetailPage() {
 		});
 	}
 
+	const showOwnerControls = !isSharedView && isAuthenticated;
+
 	return (
 		<div className="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+			{/* Shared setup banner */}
+			{isSharedView && setup && (
+				<div className="flex items-center gap-2 px-4 py-2 bg-blue-50 border-b border-blue-100 -mx-4 sm:-mx-6 lg:-mx-8 px-4 sm:px-6 lg:px-8">
+					<LucideIcon name="link" size={16} className="text-blue-500" />
+					<span className="text-sm text-blue-700">Shared setup</span>
+				</div>
+			)}
+
 			{/* Setup-specific sticky bar */}
 			<div className="sticky top-14 z-[9] bg-gray-50 border-b border-gray-100 -mx-4 sm:-mx-6 lg:-mx-8 px-4 sm:px-6 lg:px-8">
 				<div className="flex items-center justify-between h-12">
@@ -151,8 +196,8 @@ function SetupDetailPage() {
 				</div>
 			</div>
 
-			{/* Actions — only visible to authenticated users */}
-			{isAuthenticated && (
+			{/* Actions — only visible to authenticated owner (hidden in shared view) */}
+			{showOwnerControls && (
 				<div className="flex items-center gap-3 py-4">
 					{/* Add Items — desktop */}
 					<button
@@ -174,32 +219,54 @@ function SetupDetailPage() {
 						<LucideIcon name="plus" size={16} />
 					</button>
 
-					{/* Public toggle — desktop */}
+					{/* Share button — desktop */}
 					<button
 						type="button"
-						onClick={() => updateSetup.mutate({ isPublic: !setup.isPublic })}
+						onClick={() => setShareModalOpen(true)}
 						className={`hidden md:inline-flex items-center gap-1.5 px-3 py-2 text-sm font-medium rounded-lg transition-colors ${
-							setup.isPublic
+							setup.visibility === "public"
 								? "text-green-700 bg-green-50 hover:bg-green-100"
-								: "text-gray-500 bg-gray-50 hover:bg-gray-100"
+								: setup.visibility === "link"
+									? "text-blue-600 bg-blue-50 hover:bg-blue-100"
+									: "text-gray-500 bg-gray-50 hover:bg-gray-100"
 						}`}
 					>
-						<LucideIcon name="globe" size={16} />
-						{setup.isPublic ? "Public" : "Private"}
+						<LucideIcon
+							name={
+								setup.visibility === "public"
+									? "globe"
+									: setup.visibility === "link"
+										? "link"
+										: "lock"
+							}
+							size={16}
+						/>
+						Share
 					</button>
-					{/* Public toggle — mobile */}
+					{/* Share button — mobile */}
 					<button
 						type="button"
-						onClick={() => updateSetup.mutate({ isPublic: !setup.isPublic })}
+						onClick={() => setShareModalOpen(true)}
 						className={`md:hidden inline-flex items-center justify-center min-w-[44px] min-h-[44px] p-2 rounded-lg transition-colors ${
-							setup.isPublic
+							setup.visibility === "public"
 								? "text-green-700 bg-green-50 hover:bg-green-100"
-								: "text-gray-500 bg-gray-50 hover:bg-gray-100"
+								: setup.visibility === "link"
+									? "text-blue-600 bg-blue-50 hover:bg-blue-100"
+									: "text-gray-500 bg-gray-50 hover:bg-gray-100"
 						}`}
-						aria-label={setup.isPublic ? "Public" : "Private"}
-						title={setup.isPublic ? "Public" : "Private"}
+						aria-label="Share settings"
+						title="Share settings"
 					>
-						<LucideIcon name="globe" size={16} />
+						<LucideIcon
+							name={
+								setup.visibility === "public"
+									? "globe"
+									: setup.visibility === "link"
+										? "link"
+										: "lock"
+							}
+							size={16}
+						/>
 					</button>
 
 					<div className="flex-1" />
@@ -241,7 +308,7 @@ function SetupDetailPage() {
 						<p className="text-sm text-gray-500 mb-6">
 							Add items from your collection to build this loadout.
 						</p>
-						{isAuthenticated && (
+						{showOwnerControls && (
 							<button
 								type="button"
 								onClick={() => setPickerOpen(true)}
@@ -298,13 +365,13 @@ function SetupDetailPage() {
 												imageUrl={item.imageUrl}
 												productUrl={item.productUrl}
 												onRemove={
-													isAuthenticated
+													showOwnerControls
 														? () => removeItem.mutate(item.id)
 														: undefined
 												}
 												classification={item.classification}
 												onClassificationCycle={
-													isAuthenticated
+													showOwnerControls
 														? () =>
 																updateClassification.mutate({
 																	itemId: item.id,
@@ -314,6 +381,11 @@ function SetupDetailPage() {
 																})
 														: undefined
 												}
+												linkTo={
+													!showOwnerControls
+														? `/items/${item.id}?setup=${numericId}${shareToken ? `&share=${shareToken}` : ""}`
+														: undefined
+												}
 											/>
 										))}
 									</div>
@@ -324,8 +396,8 @@ function SetupDetailPage() {
 				</div>
 			)}
 
-			{/* Item Picker — only for authenticated users */}
-			{isAuthenticated && (
+			{/* Item Picker — only for authenticated owner */}
+			{showOwnerControls && (
 				<ItemPicker
 					setupId={numericId}
 					currentItemIds={currentItemIds}
@@ -334,8 +406,19 @@ function SetupDetailPage() {
 				/>
 			)}
 
-			{/* Delete Confirmation Dialog — only for authenticated users */}
-			{isAuthenticated && confirmDelete && (
+			{/* Share Modal — only for authenticated owner */}
+			{showOwnerControls && (
+				<ShareModal
+					isOpen={shareModalOpen}
+					onClose={() => setShareModalOpen(false)}
+					setupId={numericId}
+					currentVisibility={setup.visibility}
+					onVisibilityChange={(v) => updateSetup.mutate({ visibility: v })}
+				/>
+			)}
+
+			{/* Delete Confirmation Dialog — only for authenticated owner */}
+			{showOwnerControls && confirmDelete && (
 				<div className="fixed inset-0 z-50 flex items-center justify-center">
 					<div
 						className="absolute inset-0 bg-black/30"

src/db/dev-seed-data.ts

@@ -857,7 +857,7 @@ export const DEV_THREADS = [
 export const DEV_SETUPS = [
 	{
 		name: "Weekend Overnighter",
-		isPublic: true,
+		visibility: "public" as const,
 		items: [
 			{ userItemIndex: 0, classification: "base" }, // Terrapin saddle bag
 			{ userItemIndex: 3, classification: "base" }, // X-Mid 1
@@ -871,7 +871,7 @@ export const DEV_SETUPS = [
 	},
 	{
 		name: "Ultra-Light Day Ride",
-		isPublic: false,
+		visibility: "private" as const,
 		items: [
 			{ userItemIndex: 2, classification: "base" }, // Top tube pack
 			{ userItemIndex: 7, classification: "worn" }, // Nitecore NU25

src/db/dev-seed.ts

@@ -252,7 +252,7 @@ async function seedDevData(database: Db = db) {
 				.values({
 					name: setupDef.name,
 					userId,
-					isPublic: setupDef.isPublic,
+					visibility: setupDef.visibility,
 				})
 				.returning();
 			if (!setup) throw new Error(`Failed to insert setup: ${setupDef.name}`);

src/db/schema.ts

@@ -1,5 +1,4 @@
 import {
-	boolean,
 	doublePrecision,
 	integer,
 	pgTable,
@@ -57,6 +56,7 @@ export const items = pgTable("items", {
 	quantity: integer("quantity").notNull().default(1),
 	globalItemId: integer("global_item_id").references(() => globalItems.id),
 	purchasePriceCents: integer("purchase_price_cents"),
+	priceCurrency: text("price_currency").default("EUR"),
 	brand: text("brand"),
 	dominantColor: text("dominant_color"),
 	cropZoom: doublePrecision("crop_zoom"),
@@ -109,6 +109,9 @@ export const threadCandidates = pgTable("thread_candidates", {
 	cons: text("cons"),
 	sortOrder: doublePrecision("sort_order").notNull().default(0),
 	globalItemId: integer("global_item_id").references(() => globalItems.id),
+	foundPriceCents: integer("found_price_cents"),
+	foundPriceCurrency: text("found_price_currency"),
+	foundPriceDate: timestamp("found_price_date"),
 	createdAt: timestamp("created_at").defaultNow().notNull(),
 	updatedAt: timestamp("updated_at").defaultNow().notNull(),
 });
@@ -121,7 +124,7 @@ export const setups = pgTable("setups", {
 	userId: integer("user_id")
 		.notNull()
 		.references(() => users.id),
-	isPublic: boolean("is_public").notNull().default(false),
+	visibility: text("visibility").notNull().default("private"),
 	createdAt: timestamp("created_at").defaultNow().notNull(),
 	updatedAt: timestamp("updated_at").defaultNow().notNull(),
 });
@@ -139,6 +142,21 @@ export const setupItems = pgTable("setup_items", {
 	classification: text("classification").notNull().default("base"),
 });
 
+// ── Shares ─────────────────────────────────────────────────────────
+
+export const shares = pgTable("shares", {
+	id: serial("id").primaryKey(),
+	setupId: integer("setup_id")
+		.notNull()
+		.references(() => setups.id, { onDelete: "cascade" }),
+	token: text("token").notNull().unique(),
+	permission: text("permission").notNull().default("read"),
+	expiresAt: timestamp("expires_at"),
+	userId: integer("user_id").references(() => users.id),
+	createdAt: timestamp("created_at").defaultNow().notNull(),
+	revokedAt: timestamp("revoked_at"),
+});
+
 // ── Global Items ────────────────────────────────────────────────────
 
 export const globalItems = pgTable(
@@ -254,3 +272,43 @@ export const oauthTokens = pgTable("oauth_tokens", {
 	refreshExpiresAt: timestamp("refresh_expires_at").notNull(),
 	createdAt: timestamp("created_at").defaultNow().notNull(),
 });
+
+// ── Market Prices ──────────────────────────────────────────────────
+
+export const marketPrices = pgTable(
+	"market_prices",
+	{
+		id: serial("id").primaryKey(),
+		globalItemId: integer("global_item_id")
+			.notNull()
+			.references(() => globalItems.id, { onDelete: "cascade" }),
+		market: text("market").notNull(),
+		currency: text("currency").notNull(),
+		priceCents: integer("price_cents").notNull(),
+		source: text("source"),
+		createdAt: timestamp("created_at").defaultNow().notNull(),
+	},
+	(table) => [unique().on(table.globalItemId, table.market, table.currency)],
+);
+
+// ── Community Prices ───────────────────────────────────────────────
+
+export const communityPrices = pgTable(
+	"community_prices",
+	{
+		id: serial("id").primaryKey(),
+		globalItemId: integer("global_item_id")
+			.notNull()
+			.references(() => globalItems.id, { onDelete: "cascade" }),
+		userId: integer("user_id")
+			.notNull()
+			.references(() => users.id),
+		market: text("market").notNull(),
+		currency: text("currency").notNull(),
+		priceCents: integer("price_cents").notNull(),
+		priceDate: timestamp("price_date"),
+		sourceType: text("source_type").notNull(),
+		createdAt: timestamp("created_at").defaultNow().notNull(),
+	},
+	(table) => [unique().on(table.globalItemId, table.userId, table.sourceType)],
+);

src/server/index.ts

@@ -14,10 +14,13 @@ import { createRateLimit } from "./middleware/rateLimit.ts";
 import { accountRoutes } from "./routes/account.ts";
 import { authRoutes } from "./routes/auth.ts";
 import { categoryRoutes } from "./routes/categories.ts";
+import { communityPriceRoutes } from "./routes/community-prices.ts";
 import { discoveryRoutes } from "./routes/discovery.ts";
+import { exchangeRateRoutes } from "./routes/exchange-rates.ts";
 import { globalItemRoutes } from "./routes/global-items.ts";
 import { imageRoutes } from "./routes/images.ts";
 import { itemRoutes } from "./routes/items.ts";
+import { marketPriceRoutes } from "./routes/market-prices.ts";
 import { oauthRoutes, wellKnownRoute } from "./routes/oauth.ts";
 import { onboardingRoutes } from "./routes/onboarding.ts";
 import { profileRoutes } from "./routes/profiles.ts";
@@ -26,6 +29,12 @@ import { setupRoutes } from "./routes/setups.ts";
 import { tagRoutes } from "./routes/tags.ts";
 import { threadRoutes } from "./routes/threads.ts";
 import { totalRoutes } from "./routes/totals.ts";
+import {
+	getSetupItemById,
+	getSetupWithItemsById,
+} from "./services/setup.service.ts";
+import { validateShareToken } from "./services/share.service.ts";
+import { withImageUrl, withImageUrls } from "./services/storage.service.ts";
 
 // Seed default data on startup
 await seedDefaults();
@@ -129,6 +138,10 @@ app.use("/api/*", async (c, next) => {
 	c.set("db", prodDb);
 	return next();
 });
+app.use("/s/*", async (c, next) => {
+	c.set("db", prodDb);
+	return next();
+});
 
 // Rate limiting for public endpoints (per D-07, D-08)
 const browseTier = createRateLimit(120, 60_000);
@@ -163,6 +176,64 @@ app.use("/api/users/:id/profile", async (c, next) => {
 	return next();
 });
 
+// Shared setup access via token (no auth required)
+app.get("/api/shared/:token", async (c) => {
+	const db = c.get("db");
+	const token = c.req.param("token");
+	const result = await validateShareToken(db, token);
+	if (!result) return c.json({ error: "Not found" }, 404);
+	const setup = await getSetupWithItemsById(db, result.setupId);
+	if (!setup) return c.json({ error: "Not found" }, 404);
+	const enrichedItems = await withImageUrls(setup.items);
+	return c.json({ ...setup, items: enrichedItems });
+});
+
+// Shared setup item detail via token (no auth required)
+app.get("/api/shared/:token/items/:itemId", async (c) => {
+	const db = c.get("db");
+	const token = c.req.param("token");
+	const itemId = Number(c.req.param("itemId"));
+	if (!itemId || Number.isNaN(itemId))
+		return c.json({ error: "Invalid item ID" }, 400);
+	const result = await validateShareToken(db, token);
+	if (!result) return c.json({ error: "Not found" }, 404);
+	const item = await getSetupItemById(db, result.setupId, itemId);
+	if (!item) return c.json({ error: "Not found" }, 404);
+	const enriched = await withImageUrl(item);
+	return c.json(enriched);
+});
+
+// Public setup item detail (no auth required — setup must be public)
+app.get("/api/setups/:setupId/items/:itemId/public", async (c) => {
+	const db = c.get("db");
+	const setupId = Number(c.req.param("setupId"));
+	const itemId = Number(c.req.param("itemId"));
+	if (!setupId || !itemId || Number.isNaN(setupId) || Number.isNaN(itemId))
+		return c.json({ error: "Invalid ID" }, 400);
+	// Verify setup is public
+	const { setups } = await import("../db/schema.ts");
+	const { eq } = await import("drizzle-orm");
+	const [setup] = await db
+		.select({ visibility: setups.visibility })
+		.from(setups)
+		.where(eq(setups.id, setupId));
+	if (!setup || setup.visibility !== "public")
+		return c.json({ error: "Not found" }, 404);
+	const item = await getSetupItemById(db, setupId, itemId);
+	if (!item) return c.json({ error: "Not found" }, 404);
+	const enriched = await withImageUrl(item);
+	return c.json(enriched);
+});
+
+// Short share URL redirect (no auth required — before SPA catch-all)
+app.get("/s/:token", async (c) => {
+	const db = c.get("db");
+	const token = c.req.param("token");
+	const result = await validateShareToken(db, token);
+	if (!result) return c.redirect("/", 302);
+	return c.redirect(`/setups/${result.setupId}?share=${token}`, 302);
+});
+
 // Auth middleware for all data routes (userId must be available for per-user scoping)
 app.use("/api/*", async (c, next) => {
 	// Skip auth routes — they handle their own auth
@@ -175,15 +246,33 @@ app.use("/api/*", async (c, next) => {
 	// Skip public setup view (GET /api/setups/:id/public)
 	if (/^\/api\/setups\/\d+\/public$/.test(c.req.path) && c.req.method === "GET")
 		return next();
+	// Skip public setup item view (GET /api/setups/:id/items/:id/public)
+	if (
+		/^\/api\/setups\/\d+\/items\/\d+\/public$/.test(c.req.path) &&
+		c.req.method === "GET"
+	)
+		return next();
 	// Skip public tags endpoint (GET /api/tags)
 	if (c.req.path.startsWith("/api/tags") && c.req.method === "GET")
 		return next();
+	// Skip shared setup access (GET /api/shared/:token)
+	if (c.req.path.startsWith("/api/shared/") && c.req.method === "GET")
+		return next();
 	// Skip public discovery endpoints (GET /api/discovery/*)
 	if (c.req.path.startsWith("/api/discovery") && c.req.method === "GET")
 		return next();
 	// Skip public global-items endpoint (GET /api/global-items)
 	if (c.req.path.startsWith("/api/global-items") && c.req.method === "GET")
 		return next();
+	// Skip public exchange rates endpoint (GET /api/exchange-rates)
+	if (c.req.path.startsWith("/api/exchange-rates") && c.req.method === "GET")
+		return next();
+	// Skip public market prices read endpoint (GET /api/market-prices)
+	if (c.req.path.startsWith("/api/market-prices") && c.req.method === "GET")
+		return next();
+	// Skip public community prices read endpoint (GET /api/community-prices)
+	if (c.req.path.startsWith("/api/community-prices") && c.req.method === "GET")
+		return next();
 	// All other methods require auth for userId resolution
 	return requireAuth(c, next);
 });
@@ -203,6 +292,9 @@ app.route("/api/discovery", discoveryRoutes);
 app.route("/api/global-items", globalItemRoutes);
 app.route("/api/onboarding", onboardingRoutes);
 app.route("/api/tags", tagRoutes);
+app.route("/api/exchange-rates", exchangeRateRoutes);
+app.route("/api/market-prices", marketPriceRoutes);
+app.route("/api/community-prices", communityPriceRoutes);
 
 // MCP server (conditionally mounted)
 if (process.env.GEARBOX_MCP !== "false") {

src/server/routes/account.ts

@@ -114,7 +114,7 @@ app.post("/delete", zValidator("json", deleteAccountSchema), async (c) => {
 		await tx
 			.update(setups)
 			.set({ userId: sentinel.id })
-			.where(and(eq(setups.userId, userId), eq(setups.isPublic, true)));
+			.where(and(eq(setups.userId, userId), eq(setups.visibility, "public")));
 
 		// 3. Get private setup IDs for cleanup
 		const privateSetups = await tx

src/server/routes/community-prices.ts

@@ -0,0 +1,47 @@
+import { zValidator } from "@hono/zod-validator";
+import { Hono } from "hono";
+import { submitCommunityPriceSchema } from "../../shared/schemas.ts";
+import {
+	getCommunityPriceStats,
+	submitCommunityPrice,
+} from "../services/community-price.service.ts";
+
+const app = new Hono();
+
+// GET /:globalItemId — returns community price stats for a catalog item (public)
+app.get("/:globalItemId", async (c) => {
+	const db = c.get("db");
+	const globalItemId = Number(c.req.param("globalItemId"));
+	if (Number.isNaN(globalItemId)) return c.json({ error: "Invalid ID" }, 400);
+
+	const market = c.req.query("market");
+	const stats = await getCommunityPriceStats(db, globalItemId, market);
+	return c.json(stats);
+});
+
+// POST / — submit a community price (authenticated, ownership validated)
+app.post("/", zValidator("json", submitCommunityPriceSchema), async (c) => {
+	const db = c.get("db");
+	const userId = c.get("userId");
+	if (!userId) return c.json({ error: "Unauthorized" }, 401);
+
+	const data = c.req.valid("json");
+	const result = await submitCommunityPrice(db, {
+		...data,
+		userId,
+	});
+
+	if (!result) {
+		return c.json(
+			{
+				error:
+					"You must own an item linked to this catalog entry to submit a price",
+			},
+			403,
+		);
+	}
+
+	return c.json(result);
+});
+
+export { app as communityPriceRoutes };

src/server/routes/exchange-rates.ts

@@ -0,0 +1,16 @@
+import { Hono } from "hono";
+import { getExchangeRates } from "../services/currency.service.ts";
+
+const app = new Hono();
+
+// GET / — returns current exchange rates (public, no auth required)
+app.get("/", async (c) => {
+	try {
+		const rates = await getExchangeRates();
+		return c.json(rates);
+	} catch (_error) {
+		return c.json({ error: "Exchange rates unavailable" }, 503);
+	}
+});
+
+export { app as exchangeRateRoutes };