Buttons & style
Primary button colour, padding, border, plus per-component radius and shadow.
Updated 2026-05-09
Theme settings → Buttons and Style.
Button settings
| Setting | Used for |
|---|---|
| Padding (Y / X) | Vertical and horizontal padding for primary buttons |
| Border width | Outline thickness (1px default, set 0 for fill-only style) |
| Background | Primary button fill — overrides body text colour as the default |
| Text | Primary button text |
| Secondary text | "Secondary" outline-style button text |
Buttons are rendered via the global .btn class set. To make a button look outlined, use class btn btn--secondary. Filled = btn btn--primary. Link-style = btn btn--link. Sections that have button blocks expose this as a Button style select.
Border radius
Six independent radius scales (Theme settings → Style → Radius):
| Token | Used for |
|---|---|
radius_button | Buttons (primary, secondary), input chips |
radius_card | Product cards |
radius_collection_card | Collection cards (collection-list / list-collections) |
radius_blog_card | Blog cards (Journal section) |
radius_image | Image blocks (hero, content image with text) |
radius_input | Form inputs (search, contact form, qty stepper) |
radius_badge | Sale / New / custom badges |
radius_drawer | Cart drawer top corners (rounded bottom-sheet on mobile) |
Each takes a px value. 0 = sharp corners (the default for the editorial preset). Try 4–8px for a softer look or 999px on radius_button for fully rounded pills.
Shadows
Two shadow tokens with three named intensities:
shadow_card— used on product cards (controlled by Card style in Product cards settings)shadow_drawer— used on cart drawer
Options: none / soft / medium / strong.
soft = 0 8px 24px rgba(0,0,0,0.06) — barely visible elevation.
strong = 0 20px 48px rgba(0,0,0,0.16) — clearly floating.
Card style
Theme settings → Product cards → Card style:
- Flat — no shadow, no border (default editorial)
- Bordered — 1px divider border
- Shadowed — uses the
shadow_cardtoken
Switching between these is purely visual; the underlying card layout doesn't change.
Hover lift
Theme settings → Style → Hover shadow (checkbox). Adds a subtle elevation on hover for product cards. Disabled by default — turn on if your card style is Flat and you want a hover affordance.
