Found Slowly Surface Hub

Shopify Surfaces

Use Preview for production-like fixes, Sandbox for visible experiments, and Live only after explicit publish approval.

Live storefront foundslowly.com
Theme #192730923140, customer-facing. Found Slowly Preview preview_theme_id=193172603012
Current staging-like lane for shippable fixes.

Found Slowly Sandbox 1 preview_theme_id=193126465668
Formerly labeled staging in older notes. Reconcile before pushing. Found Slowly Sandbox preview_theme_id=193126662276
Experimental design, navigation, and process-media exploration.

Shopify Editors

Admin links require the store login. Keep this page local because these are operational shortcuts.

Live theme editor#192730923140 Preview theme editor#193172603012 Sandbox 1 editor#193126465668 Sandbox editor#193126662276

Cloudflare Surfaces

These are support and review surfaces, not the canonical storefront. R2 holds private review media; D1 currently holds the small product/image registry.

Review Worker Serves R2 review media from found-slowly-images. Review Worker health Lightweight deployed status check. Countdown Worker Launch utility. Current target date is past. Countdown Worker health Lightweight deployed status check.

Process Media Registry

The better process/media surface is this local image-object inventory and its boards. It tracks roles, paths, derivatives, hashes, and known Cloudflare R2 keys.

Image object browser tools/image-object-inventory-2026-05-29/image-object-browser.html
Filter by process_frame_or_candidate, Cloudflare availability, source family, and context. Review media board boards/review-media-post-planning.html
R2-backed thumbnails, visual strips, and contact sheets for post planning. Image object system note FOUND_SLOWLY_IMAGE_OBJECT_SYSTEM.md
Explains object classes, derivative policy, and how this should feed website/archive work. Registry JSON found-slowly-image-objects.json
3,567 image objects, including 2,160 process frame or candidate records.

Current verification: remote D1 found-slowly-db has pieces and images rows for product hero media only. The process-photo registry is the local image-object inventory; Cloudflare R2 currently contributes known review-package keys under reviews/2026-05-14-next-cuts/ and reviews/2026-05-15-instagram-ready-10/.

Version Control

Generated from notes/site-review/surface-hub-registry.json. Run python3 scripts/update_surface_hub.py before deploying this hub.

Git state: branch codex/found-slowly-surface-hub-harness, remotes 0, registry 2026-06-28.1, hub shell hash 09aa575e4623. Exact commit snapshots live in the version ledger and git history. Release gate clear for required concepts.

Concept status: clean: 11, external: 1, untracked: 1. Version snapshots are appended to notes/site-review/surface-hub-version-ledger.jsonl with --record-version.

Concept	Kind	Source	Git	Version Note
Surface Hub `surface-hub`	ops-harness `required`	`notes/site-review/found-slowly-surface-hub.html https://found-slowly-surface-hub.pages.dev/`	clean	One-page entry point for current live, preview, sandbox, Cloudflare, registry, and decision surfaces.
Site Review Harness `site-review-harness`	procedure `required`	`notes/site-review/review-harness.md`	clean	Repeatable UX/site-quality review sequence and release-surface vocabulary.
Theme Release Workflow `theme-release-workflow`	procedure `required`	`notes/site-review/theme-release-workflow.md`	clean	Shopify Production/Preview/Sandbox operating rules and release gate.
Preview And Access Workflow `preview-access-workflow`	procedure `required`	`notes/site-review/preview-and-access-workflow.md`	clean	Authenticated Shopify/Cloudflare access notes and repeatable checks.
Storefront Audit Script `storefront-audit-script`	validator `required`	`scripts/audit_foundslowly_site.py`	clean	HTML route/meta/heading/JSON-LD/link audit for live and preview surfaces.
Surface Hub Registry `surface-hub-registry`	registry `required`	`notes/site-review/surface-hub-registry.json`	clean	Concept and version registry that the git-sensitive hub update script reads.
Surface Hub Version Ledger `surface-hub-version-ledger`	ledger `required`	`notes/site-review/surface-hub-version-ledger.jsonl`	clean	Append-only records of hub updates, git state, and deployment snapshots.
Surface Hub Update Script `surface-hub-update-script`	validator `required`	`scripts/update_surface_hub.py`	clean	Renders the hub's git/version section and checks release-gate cleanliness.
Surface Hub Harness Tests `surface-hub-harness-tests`	test `required`	`tests/test_surface_hub_harness.py`	clean	Unit tests for status classification, generated-section insertion, and render stability.
Process Media Registry `process-media-registry`	local-reference-archive `reference-local`	`tools/image-object-inventory-2026-05-29/found-slowly-image-objects.json`	untracked ?? tools/image-object-inventory-2026-05-29/found-slowly-image-objects.json	Large local image-object registry. Keep surfaced as local/reference unless an explicit public promotion package is created.
Shopify Preview Theme Source `shopify-theme-preview-source`	theme-source `required`	`shopify-theme/preview`	clean	Local source for Found Slowly Preview #193172603012.
Shopify Sandbox Theme Source `shopify-theme-sandbox-source`	theme-source `required`	`shopify-theme/experimental`	clean	Local source for Found Slowly Sandbox #193126662276.
Cloudflare Pages Surface `cloudflare-pages-surface`	deployment `external`	`https://found-slowly-surface-hub.pages.dev/`	external	Public static copy of the local hub. Re-deploy from the local hub only after running the git-sensitive harness update.

Local Sources

These links work from this machine and point at the durable folders behind each surface.

Preview sourceshopify-theme/preview/ Sandbox 1 sourceshopify-theme/sandbox-1/ Sandbox sourceshopify-theme/experimental/ Live diagnostic pullshopify-theme/live-pull-20260624-soldout-diagnostic/

Workflow Docs

Local references that explain the release lanes, data boundaries, and audit harness.

Preview and access workflownotes/site-review/preview-and-access-workflow.md Theme release workflownotes/site-review/theme-release-workflow.md Site review harnessnotes/site-review/review-harness.md Live site and data architecturenotes/engineering-review/live-site-data-architecture.md

Storefront Decision

Current recommendation: build and maintain Found Slowly as a Liquid theme. Do not introduce Hydrogen unless the storefront becomes genuinely app-like.

Decision: Liquid plus Dawn is the right lane for Found Slowly now. Shopify remains the public source of truth for products, collections, checkout, navigation, redirects, SEO metadata, and theme content. Cloudflare remains support infrastructure for private review media and small non-storefront tools.

Use Liquid For

Product, collection, home, event, about, cart, and SEO pages.
Metafields for provenance, condition notes, care, era, story, and one-of-one details.
Theme-editor friendly sections that Taylor or Garen can adjust without a React build pipeline.

Skip Hydrogen Because

The catalog is small, curated, and Shopify-native.
POS plus Shopify storefront already covers booth and online selling.
Headless React would add routing, API, hosting, deployment, and app-integration maintenance with little payoff.

Concept	Meaning	Found Slowly Call
Liquid	Server-rendered Shopify theme templates. Shopify fills the HTML before page load.	Primary storefront path.
React	Browser-side UI library for stateful interactivity.	Use only in small, isolated components if ever needed.
Hydrogen	React storefront framework using Shopify's Storefront API, usually hosted outside normal themes.	Not recommended for current needs.

Hydrogen revisit test

Reopen the Hydrogen question only if one of these becomes true:

Complex live configurators, dependent filtering, or custom merchandising logic become central.
A separate CMS or multiple external data sources become part of the public storefront.
One frontend needs to feed many surfaces beyond Shopify storefront and POS.
Edge personalization or server-side A/B testing becomes a real requirement.
Found Slowly has ongoing React engineering capacity for maintenance.

Current practical next actions

Reconcile old docs that still call #193126465668 “Staging”; Shopify currently names it Found Slowly Sandbox 1.
Keep shopify-theme/preview/ aligned with Found Slowly Preview #193172603012 if that remains the active release lane.
Invest design time in metafields and custom Liquid blocks for item provenance, material/process story, condition, care, and one-of-one details.
Keep process/video/review artifacts private until intentionally promoted into Shopify or a gated Worker surface.