wire shop LiveViews to DB queries and improve search UX

Replace PreviewData indirection in all shop LiveViews with direct
Products context queries. Home, collection, product detail and error
pages now query the database. Categories loaded once in ThemeHook.
Cart hydration no longer falls back to mock data. PreviewData kept
only for the theme editor.

Search modal gains keyboard navigation (arrow keys, Enter, Escape),
Cmd+K/Ctrl+K shortcut, full ARIA combobox pattern, LiveView navigate
links, and 150ms debounce. SearchModal JS hook manages selection
state and highlight. search.ex gets transaction safety on reindex
and a public remove_product/1. 10 new integration tests.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

PROGRESS.md

@@ -16,7 +16,8 @@
 - Stripe Checkout with order persistence and webhook handling
 - Admin credentials page with guided Stripe setup flow
 - Encrypted settings for API keys and secrets
-- Search modal with keyboard shortcut
+- FTS5 full-text search with live results modal
+- Denormalized product fields (cheapest_price, in_stock, on_sale) for DB-level sort/filter
 - Transactional emails (order confirmation, shipping notification)
 - Demo content polished and ready for production
 
@@ -26,7 +27,7 @@
 
 Ordered by dependency level — admin shell chain first (unblocks most downstream work).
 
-Plans: [admin-redesign.md](docs/plans/admin-redesign.md) | [setup-wizard.md](docs/plans/setup-wizard.md) | [search.md](docs/plans/search.md)
+Plans: [admin-redesign.md](docs/plans/admin-redesign.md) | [setup-wizard.md](docs/plans/setup-wizard.md) | [search.md](docs/plans/search.md) | [products-refactor.md](/home/jamey/.claude/plans/snug-roaming-zebra.md)
 
 | # | Task | Depends on | Est | Status |
 |---|------|------------|-----|--------|
@@ -45,11 +46,10 @@ Plans: [admin-redesign.md](docs/plans/admin-redesign.md) | [setup-wizard.md](doc
 | ~~12~~ | ~~Consolidate settings page~~ | 6, 7 | 2-3h | done |
 | ~~13~~ | ~~Admin dashboard (+ setup checklist)~~ | 6, 7, 9 | 2h | done |
 | ~~15~~ | ~~Setup wizard + admin tests~~ | 13 | 1.5h | done |
+| ~~5~~ | ~~Search (functional search with results)~~ | — | 3-4h | done |
+| ~~17~~ | ~~Wire shop LiveViews to DB queries (replace PreviewData indirection)~~ | — | 2-3h | done |
 | | **Next up** | | | |
-| 5 | Search (functional search with results) | — | 3-4h | |
-| | **Needs admin stable** | | | |
 | 16 | Variant refinement with live data | — | 2-3h | |
-| 17 | Wire real product data to shop pages | — | 2-3h | |
 | 18 | Shipping costs at checkout | 17 | 2-3h | |
 | | **CSS migration (after admin stable)** | | | |
 | 19 | Admin design tokens (`admin-tokens.css`) | 12 | 30m | |
@@ -89,9 +89,9 @@ Issues from hands-on testing of the deployed prod site (Feb 2025). 15 of 18 comp
 
 ### Tier 4 — Growth & content
 
-13. **Page editor** — Database-driven pages with drag-and-drop sections. Extend the theme system to custom pages beyond the defaults. Replaces the static content pages from Tier 1 with editable versions.
+13. **Page editor** — Database-driven pages with drag-and-drop sections. Extend the theme system to custom pages beyond the defaults. Replaces the static content pages from Tier 1 with editable versions. **Removes PreviewData usage from `content.ex`** (about, delivery, privacy, terms content blocks are currently hardcoded in PreviewData).
 14. **Newsletter & email marketing** — Email list collection (signup forms). Campaign sending for product launches, sales. Can be simple initially (collect emails, send via Swoosh) or integrate with a service.
-15. **Product page improvements** — Pre-checkout variant validation (verify Printify availability). Cost change monitoring/alerts. Better image gallery (zoom, multiple angles).
+15. **Product page improvements** — Pre-checkout variant validation (verify Printify availability). Cost change monitoring/alerts. Better image gallery (zoom, multiple angles). **Product reviews system** to replace the hardcoded `PreviewData.reviews()` on the PDP template.
 
 ### Tier 5 — Platform vision
 
@@ -282,6 +282,24 @@ All shop pages now have LiveView integration tests (612 total):
 - Oban job duration/count and LiveView mount/event telemetry metrics
 - os_mon for CPU, disk, and OS memory in LiveDashboard
 
+### Products Refactor & Search
+**Status:** Complete
+
+- [x] Denormalized product fields (cheapest_price, compare_at_price, in_stock, on_sale) recomputed from variants after sync
+- [x] Product display helpers (primary_image, hover_image, option_types) and ProductImage helpers (display_url, direct_url, source_width)
+- [x] Products context storefront queries (list_visible_products, get_visible_product, list_categories) with DB-level sort/filter
+- [x] Renamed .name → .title across all shop components and templates
+- [x] PreviewData updated to struct-compatible format (removed product_to_map indirection)
+- [x] FTS5 full-text search index with BM25 ranking (title 10x, category 5x, variants 3x, description 1x)
+- [x] SearchHook on_mount for all shop pages (follows CartHook pattern)
+- [x] Search modal with live results (thumbnails, titles, categories, prices, click-to-navigate)
+- [x] Index auto-rebuilds after each provider sync
+- [x] 18 search tests, 744 total
+
+**Follow-ups:**
+- [x] Wire shop LiveViews to direct DB queries (PreviewData removed from all shop pages, cart, error page)
+- [ ] Keyboard navigation in search modal (up/down arrows, Enter to navigate)
+
 ### Page Editor
 **Status:** Future (Tier 4)
 
@@ -295,6 +313,7 @@ See: [docs/plans/page-builder.md](docs/plans/page-builder.md) for design
 
 | Feature | Commit | Notes |
 |---------|--------|-------|
+| FTS5 search + products refactor | 037cd16 | FTS5 index, BM25 ranking, search modal, denormalized fields, Product struct usage, 744 tests |
 | PageSpeed CI | 516d0d0 | `mix lighthouse` task, prod asset build, gzip, 99-100 mobile scores |
 | Observability | eaa4bbb | LiveDashboard in prod, ErrorTracker, JSON logging, Oban/LV metrics, os_mon |
 | Hosting & deployment | — | Alpine Docker, Fly.io, health check, release path fixes |