Skip to content

Colors ​

Guppy follows a structured color system. All colors are configurable from the theme settings, changes propagate to the compiled storefront immediately.

Brand colors ​

The two central theme colors:

FieldDefaultUse
Primary (sw-color-brand-primary)#215AFFButtons, links, accents
Secondary (sw-color-brand-secondary)#0B1845Header (default), secondary accents

Changing the brand color

A changed primary color propagates automatically into buttons, links, focus outlines, and hover states. Secondary mostly affects the header and secondary buttons.

Focus and form field colours ​

Two optional colours in the Theme colours block (since Guppy 2.9.0). Leave them empty to keep the current look.

FieldEmpty meansUse
Focus colour (guppy-focus-color)Primary colourOutline, ring and shadow that show keyboard focus on links, buttons and form fields
Form field border (guppy-input-border-color)Border colourBorders of input fields, selects, checkboxes, radios and dropdown menus

Contrast for focus and form fields

Both need at least 3:1 contrast (WCAG 1.4.11): the focus colour against the colours next to it, the form field border against the background. Set a focus colour if your primary colour is light, and a form field border if your general border colour is too light for form fields.

System status colors ​

Used in alerts and status indicators:

StatusDefault background
Success#D3F2E7
Info#CEEDFE
Warning#FFEFD4
Danger#FDE2E7

Each status has additional controls for text color (light/dark) and an outline toggle.

Greyscales ​

A 9-step scale (gray-100 to gray-900) for backgrounds, borders, dividers, and secondary text.

StepDefaultTypical use
100#F9F9F9Backgrounds, footer
200#EEEEEEDisabled elements
300#BCC1C7Borders
400#CED4DAInput borders
500#ADB5BDPlaceholders
600#798490Secondary text
700#495057Text
800#4A545BHeadlines
900#212529Body text

E-commerce colors ​

Specific to delivery and order status, defined in the Detailpage and Productcard theme tabs.

StatusBackgroundText color
Free shipping#CEEDFE#023B5A
Available#D3F2E7#154634
Restock#FFEFD4#5D3B00
Sold out#EEEEEE#303030

Badges ​

Product card badges (New, Top-Seller, Discount) are colorable per badge:

BadgeDefault background
New#22C087
Top-Seller#F89C00
Discount#E10036

Notes ​

Check contrast

With custom color choices, always check WCAG contrast (at least 4.5:1 for normal text). Tools: WebAIM Contrast Checker.

Full reference

All color fields with defaults: Config Schema.