Theme presets
A theme preset is a named storefront look (fonts, layout, surface styling). You pick one as data in the tenant config, and override its accent colours at runtime without a rebuild.
The presets that ship
Section titled “The presets that ship”Set theme_preset in the tenant config to one of:
theme_preset |
Look |
|---|---|
default |
The neutral baseline (the model default). |
belltex |
The launch fashion theme (theme #1). |
clean-premium |
Understated and premium — lots of whitespace. |
bold-trendy |
High-contrast, punchy, trend-forward. |
minimal |
Stripped-back and typographic. |
The theme settings
Section titled “The theme settings”| Setting | Purpose | Default | Where |
|---|---|---|---|
theme_preset |
Which preset stylesheet the storefront loads | default |
Tenant config → Theme (admin form) |
container_max_width |
Storefront content container max width (px) | 1280 |
Tenant config → Theme (admin form) |
theme_tokens |
Runtime colour-token overrides applied on top of the preset | {} |
Tenant config data (set by the setup wizard / config); BRAND_ACCENT env is the fallback for the accent |
Overriding the accent (and derivatives)
Section titled “Overriding the accent (and derivatives)”theme_tokens is a JSON map of semantic colour keys the frontends map to CSS
variables. Setting accent recolours buttons, links, hovers and highlights — the
storefront derives hover/pressed/soft shades from it automatically:
{ "accent": "#0e7490", "brand-ink": "#0c4a6e" }Values must be valid CSS colours (the frontends validate them before applying).
The BRAND_ACCENT env var is the fallback when theme_tokens.accent is unset —
see Store settings & branding.