Skip to content
New: Customize your theme with an AI assistant. Read the guide

Colors & Fonts

Files: src/styles/theme.css, src/config/fonts.json, src/config/config.toml ([settings.colorScheme]) · Skill level: Beginner

A rebrand in Plumbo is a handful of values, not a search-and-replace. Every component uses named color tokens, so changing a token changes it everywhere, including the logo mark and the generated social cards. Plumbo has a light palette and a dark palette.

Plumbo homepage in dark mode

Where The Colors Live

Open src/styles/theme.css. The values are in two blocks:

  • :root { ... }: the light palette (the default)
  • :root.dark { ... }: the dark palette

Each value is a --theme-* variable. Components never use hex codes: they use Tailwind classes such as bg-sage or text-primary, which read these variables. Change a value in both blocks, and keep the variable names.

The Color Tokens

RoleVariableLightDarkTailwind classes
Page background--theme-body#ffffff#0b1220bg-body
Cards and white surfaces--theme-card#ffffff#0b1220bg-card
Cool grey panels (reviews, blog, FAQ rows)--theme-sage#f4f6f9#121b2bbg-sage
Peach tint (icon circles, chips)--theme-mint#fdede4#2a1a12bg-mint
Soft peach (service cards, quote card, savings tiles)--theme-blush#fff3ec#261811bg-blush
Warm stone (the main homepage)--theme-cream#f6f2ec#15181dbg-cream
Brand orange block (stats band, emergency band)--theme-deep#cf4510#b23c0ebg-deep
Navy (dark blocks, dark footers)--theme-forest#0f1e33#08101cbg-forest
Text orange (links, icons, checks)--theme-primary#c2410c#ff8a57text-primary, bg-primary
Text orange on hover--theme-primary-hover#a8380a#ffa47ctext-primary-hover
Text on text orange--theme-on-primary#ffffff#0b1220text-on-primary
Button orange (main pill buttons)--theme-accent#cf4510#cf4510bg-accent
Button orange on hover--theme-accent-hover#b33b0d#e0531bbg-accent-hover
Text on button orange--theme-on-accent#ffffff#fffffftext-on-accent
Darker orange for small accents on white--theme-accent-strong#a8380a#ff8a57text-accent-strong
Headings (navy ink)--theme-dark#0f1b2c#eef2f7text-dark
Body text--theme-text-default#576173#a6b0bftext-text-default
Borders and dividers--theme-border-light#e3e7ed#233046border-border-light
Form field borders--theme-border-input#7a8494#6d7889border-border-input
Focus ring--theme-focus#cf4510#ff8a57ring-focus, outline-focus
States--theme-danger, --theme-success, --theme-warning#b42318, #1f7a3a, #9a5a00#f2726a, #5cc283, #f0b44ctext-danger, …

--theme-light and --theme-primary-soft repeat the peach tint, and --theme-sand repeats the grey panel. Change them together with --theme-mint and --theme-sage. Some token names (sage, mint, forest) are kept from older versions: the comment at the top of theme.css says what each one is now.

Copies To Change With The Palette

A few values appear twice in theme.css. Update them with the main tokens:

  • --page-* variables at the end of :root and :root.dark (--page-primary, --page-dark, --page-text, …). Cards on a colored block (a white card on the orange block) use them to get the page colors back. Keep them equal to the matching --theme-* values.
  • Static helpers in the @theme inline block, which stay the same in light and dark mode: --color-emerald and --color-sunflower (both #cf4510, the brand orange; the names are kept), --color-mist (#fdede4, white button hover), --color-light (#c3cbd8, text on the navy footers), and --color-body-dark (#0f1b2c).
  • The colored blocks under @layer components: .block-deep (the orange brand block), .block-forest (the navy block), and .block-coral (the name is kept: an orange block on --theme-accent, with white text). They set the text and border colors used inside each block.
  • .band-ink: the navy ink band, which uses the dark palette inside it.

The #cf4510 orange also appears in src/assets/images/favicon.svg and the two standalone logo files. Regenerate the favicon after a color change (see Site Identity & Logo).

Button Styles

Buttons in content files take their look from variant:

You writeButton
variant: "fill"The main pill button: button orange with white text
variant: "accent"A text-orange pill with white text, for form buttons on light panels. One per view
variant: "soft"A peach pill with ink text for the second action; orange on hover
variant: "outline"An outlined pill
variant: "fill-white"A white pill, for photos and colored blocks
variant: "text"A text link with an arrow

The styles are in src/styles/buttons.css. Some sections change a variant to fit their background; the comment next to variant: in the section file says when. See Common Changes for every button option.

Corners

The radius tokens are in the @theme inline block of theme.css:

TokenValueUsed forClass
--radius-btn9999px (a pill)Buttons and icon buttonsrounded-btn
--radius-field0.625rem (10 px)Inputs, selects, segmented controlsrounded-field
--radius-ui1.5rem (24 px)Cards, tiles, imagesrounded-ui
--radius-panel2rem (32 px)Large photos and soft panelsrounded-panel
--radius-block2rem (32 px)Color blocks and the footer panelrounded-block
--radius-tag0.375rem (6 px)Check squares and rating squaresrounded-tag

For square buttons, for example, set --radius-btn: 0.5rem;. Plumbo uses no shadows: the shadow scales are reset.

Fonts

Plumbo uses four fonts from Google Fonts, set in src/config/fonts.json, one entry per role:

FontRolecssVariable
FigtreeBody text and forms--font-primary
ManropeHeadings, buttons, and big numbers--font-heading
JetBrains MonoPrices, totals, and ticket codes--font-code
IBM Plex Sans ArabicArabic text, loaded only on Arabic pages--font-arabic
{
"name": "Manrope",
"variants": [{ "style": "normal", "weight": "400 700" }],
"preload": true,
"display": "swap",
"cssVariable": "--font-heading",
"provider": "google",
"subsets": ["latin"],
"fallback": "sans-serif"
}

To change a font, replace name with another Google Font name, exactly as Google writes it ("DM Sans", "Plus Jakarta Sans"). Keep cssVariable, provider, and fallback, and keep a weight range the new font has: Plumbo ships "400 700" for both Manrope and Figtree. Add a subset such as "latin-ext" if your language needs it. Then restart npm run dev: fonts are read only when the server starts.

Astro downloads the fonts and serves them from your own site, so visitors don’t load anything from Google.

Type Sizes

Heading sizes are fluid: they grow from phone to desktop between 375 px and 1280 px wide (--text-h1 from 36 px to 52 px, --text-display from 40 px to 64 px). They are in theme.css as --text-display, --text-h1 to --text-h6, --text-stat (big numbers), --text-lead, --text-copy (body, 16 px), --text-label (small caps labels), and --text-total / --text-total-lg (prices). Each has a --line-height, --letter-spacing, and --font-weight beside it. Headings use weight 500 with tight letter spacing (-0.03em on the display size, h1, and h2).

Breakpoints

sm 540 px, md 768 px, lg 1024 px, xl 1320 px. The mobile action bar shows below md; the full header menu shows from lg.

Dark Mode

src/config/config.toml
[settings.colorScheme]
default = "light" # system | light | dark: used until a visitor picks one
switcher = true # Show the light/dark button in the header, mobile menu, and footer
  • Plumbo ships with light. system follows the visitor’s device setting, and light or dark starts every visitor on that palette.
  • The sun and moon button switches it. The visitor’s choice is remembered in their browser.
  • switcher = false hides every button. Visitors then always get default, and an earlier choice is ignored. Use switcher = false with default = "light" for a site without dark mode.

When you change colors, check both palettes. Photos and the orange buttons stay the same in dark mode.

Do It With AI

My brand colors are: main [HEX] and button color [HEX]. In src/styles/theme.css, in :root,
set --theme-deep to my main color, and --theme-primary and --theme-primary-hover to darker
shades of it with at least 4.5:1 contrast on #ffffff and #f4f6f9. Set --theme-accent and
--theme-accent-hover to my button color, and --theme-on-accent to black or white, whichever
contrasts more. Make versions for :root.dark. Update the matching --page-* values,
--color-emerald, and --color-sunflower. Keep every variable name. List the values and their
contrast ratios.
Change the heading font to [GOOGLE FONT] and the body font to [GOOGLE FONT] in
src/config/fonts.json. Keep the cssVariable values, the provider, and the fallback, and use
weight ranges the fonts have. Don't edit CSS files. Then tell me to restart npm run dev.
Type something to search...