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.

Whole page
<body data-blk-theme="ocean" data-blk-fonts="editorial">
One section only
<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

Use it
<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.

Use it
<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.

Use it
<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.

Use it
<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.

Use it
<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.

TokenDefaultWhat it does
--blk-accent#800020
--blk-accent-dark#5e0018hover and pressed
--blk-on-accent#fffffftext on a filled accent button
--blk-bg#ffffff
--blk-dark#1b2329dark rounded boxes, dark buttons
--blk-darker#141a1fthe darkest box surface
--blk-deep#080c12full-width dark band behind the case-study panels
--blk-band-a#f4e6e6tinted band one (warm)
--blk-band-b#dde6eftinted band two (cool)
--blk-band-c#efe6d2tinted band three (champagne)
--blk-surface#ffffffcards and panels that sit on a tinted band
--blk-cta#1e3a5fclosing call-to-action band
--blk-secondary#1e3a5fsecond accent: dates, row markers
--blk-highlight#c9a227third accent: row markers, ratings
--blk-heading#20282d
--blk-ink#263037
--blk-muted#54606a
--blk-line#e3e8ea
--blk-on-dark#ffffff
--blk-on-dark-muted#d3dce5body text on dark surfaces
--blk-on-dark-accent#ff9fb2small 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-weight600400 for display serifs that have one weight
--blk-font-serif"DM Serif Display", Georgia, "Times New Roman", serifdisplay and quote type
--blk-radius8px
--blk-radius-lg16px
--blk-radius-xl22px
--blk-container1200px
--blk-container-narrow820pxreading measure
--blk-shadow0 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.