# Phase 29: Image Presentation - 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-12
**Phase:** 29-image-presentation
**Areas discussed:** Fit strategy & fill treatment, Aspect ratio policy, Scope of changes, User crop positioning

---

## Fit Strategy & Fill Treatment

| Option | Description | Selected |
|--------|-------------|----------|
| Blurred background | Scale to fit, fill with blurred zoomed version of same image | |
| Solid background | Scale to fit, fill with solid color (white/gray) | |
| Adaptive background | Extract dominant color from image, use as fill | ✓ |

**User's choice:** Adaptive background

| Option | Description | Selected |
|--------|-------------|----------|
| Client-side on load | Canvas pixel sampling when image loads | |
| Server-side on upload | Extract once on upload, store in DB | ✓ |
| You decide | Claude picks | |

**User's choice:** Server-side on upload

---

## Aspect Ratio Policy

| Option | Description | Selected |
|--------|-------------|----------|
| Keep different ratios | 4:3 for cards, 16:9 for detail heroes | |
| Unify to 4:3 | Same everywhere | |
| Unify to 16:9 | Wider everywhere | |
| You decide | Claude picks based on gear images | ✓ |

**User's choice:** You decide (Claude's discretion)

---

## Scope of Changes

| Option | Description | Selected |
|--------|-------------|----------|
| Everywhere images appear | All 15+ surfaces — full consistency | ✓ |
| Cards and detail pages only | Main surfaces, skip comparison/upload | |
| You decide | Claude picks | |

**User's choice:** Everywhere images appear

---

## User Crop Positioning

| Option | Description | Selected |
|--------|-------------|----------|
| Focal point picker | Click to set focal point, x/y coordinates | |
| Zoom + pan editor | Zoom in/out and drag to position | ✓ |
| No user control | Skip for now, add later | |

**User's choice:** Zoom + pan editor

| Option | Description | Selected |
|--------|-------------|----------|
| On upload preview | Editor during upload only | |
| On item edit/detail | Editor from item detail page | |
| Both | Available during upload AND from item detail | ✓ |

**User's choice:** Both

| Option | Description | Selected |
|--------|-------------|----------|
| Per-image (one crop for all views) | Same framing everywhere | ✓ |
| Per-context | Different crop for card vs detail | |

**User's choice:** Per-image

---

## Claude's Discretion

- Aspect ratio policy (unify or keep different)
- Zoom+pan editor implementation (library vs custom)
- Dominant color extraction library
- DB schema design for crop and color fields
- Backfill migration strategy

## Deferred Ideas

None — discussion stayed within phase scope
