Themes
Change the look of every block by changing a handful of CSS variables.
A theme is a wrapper
It is one attribute, not extra markup. Put data-blk-theme on the page, or on any single section, and every block inside it takes that theme. Colours, fonts and shape are separate wrappers, so you can mix them.
<body data-blk-theme="ocean" data-blk-fonts="editorial"><section class="blk-section" data-blk-theme="forest">Five themes to start from
A theme is a short file that overrides the tokens. Every one is checked at build time against WCAG contrast minimums, so a theme that fails does not ship.
oxblood
<link rel="stylesheet" href="/blocks.css">
<link rel="stylesheet" href="/themes/oxblood.css">
<body data-blk-theme="oxblood">Ocean
Teal accent on deep navy, cool pale bands.
<link rel="stylesheet" href="/blocks.css">
<link rel="stylesheet" href="/themes/ocean.css">
<body data-blk-theme="ocean">Forest
Deep green accent on charcoal, soft sage and sand bands.
<link rel="stylesheet" href="/blocks.css">
<link rel="stylesheet" href="/themes/forest.css">
<body data-blk-theme="forest">Sunrise
Burnt orange accent on warm charcoal, peach and cream bands.
<link rel="stylesheet" href="/blocks.css">
<link rel="stylesheet" href="/themes/sunrise.css">
<body data-blk-theme="sunrise">Graphite
Near-monochrome: ink-blue accent, neutral greys. A calm base to build your own brand on.
<link rel="stylesheet" href="/blocks.css">
<link rel="stylesheet" href="/themes/graphite.css">
<body data-blk-theme="graphite">Make your own
Copy any theme, change the values, and keep the contrast pairs above their minimums.
| Token | Default | What it does |
|---|---|---|
--blk-accent | #800020 | |
--blk-accent-dark | #5e0018 | hover and pressed |
--blk-on-accent | #ffffff | text on a filled accent button |
--blk-bg | #ffffff | |
--blk-dark | #1b2329 | dark rounded boxes, dark buttons |
--blk-darker | #141a1f | the darkest box surface |
--blk-deep | #080c12 | full-width dark band behind the case-study panels |
--blk-band-a | #f4e6e6 | tinted band one (warm) |
--blk-band-b | #dde6ef | tinted band two (cool) |
--blk-band-c | #efe6d2 | tinted band three (champagne) |
--blk-surface | #ffffff | cards and panels that sit on a tinted band |
--blk-cta | #1e3a5f | closing call-to-action band |
--blk-secondary | #1e3a5f | second accent: dates, row markers |
--blk-highlight | #c9a227 | third accent: row markers, ratings |
--blk-heading | #20282d | |
--blk-ink | #263037 | |
--blk-muted | #54606a | |
--blk-line | #e3e8ea | |
--blk-on-dark | #ffffff | |
--blk-on-dark-muted | #d3dce5 | body text on dark surfaces |
--blk-on-dark-accent | #ff9fb2 | small caps labels on dark surfaces |
--blk-panel-1 | #5e0018 | |
--blk-panel-2 | #1e3a5f | |
--blk-panel-3 | #3b2a52 | |
--blk-panel-4 | #6b4e12 | |
--blk-font-heading | "Poppins", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif | |
--blk-font-body | "DM Sans", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif | |
--blk-heading-weight | 600 | 400 for display serifs that have one weight |
--blk-font-serif | "DM Serif Display", Georgia, "Times New Roman", serif | display and quote type |
--blk-radius | 8px | |
--blk-radius-lg | 16px | |
--blk-radius-xl | 22px | |
--blk-container | 1200px | |
--blk-container-narrow | 820px | reading measure |
--blk-shadow | 0 10px 30px rgba(0, 0, 0, 0.08) |
Want a site built on blocks like these?
I help teams plan, build and ship websites, products and automation, using AI where it makes the work faster and safer.