Storefront changes

Storefront configuration is read from the database and served through GET /storefront/config. The React app resolves those values at runtime and re-polls fresh config so safe changes can appear without rebuilding.

Common Settings

Setting	Values	Result
productDetailEnabled	true, false	Enables or disables per-product detail pages
themeId	Theme id from settings.list_themes	Changes storefront token preset
colorMode	light, dark, system	Pins or follows visitor color preference
content.footerBrandUrl	URL or null	Links or unlinks the footer brand

Footer Link Example

{
  "content": {
    "footerBrandUrl": "https://premierstudio.ai"
  }
}

The value is persisted in store_settings, not the source tree.

Themes

Agentful ships the default shadcn theme plus the tweakcn preset catalog. The storefront stores only themeId and colorMode; token values live in @shop/shared-types and are bundled with the web app.

settings.list_themes
settings.update {"themeId":"catppuccin"}
settings.update {"colorMode":"dark"}

Typography, spacing, and elevation are intentionally stable so themes change the store’s palette without changing its interaction model.