Light themes
Dark themes

Make your own

Tailwind and Figma

The tokens of the system for two more tools: a theme for Tailwind CSS, and variables for Figma with a mode for each theme.

Tailwind CSS 4

Import tailwind/theme.css after Tailwind and tokens.css. Both files are in the download.

CSS
@import "tailwindcss";
@import "./tokens.css";
@import "./tailwind/theme.css";

Every token is then a utility, under the name it has in the system:

HTML
<div class="bg-surface text-ink rounded-card p-card">
  <h2 class="text-title">Order a jar</h2>
  <p class="text-lead text-ink-soft max-w-measure">Two jars of 50 g, delivered chilled.</p>
  <button class="bg-accent text-on-accent rounded-button h-control-md px-6">Pay $127</button>
</div>
TokensUtilities
Every colour: --page, --ink, --accent, --data-1 and the restbg-page, text-ink, bg-accent, border-hairline, fill-data-1
The corners: --radius-card to --radius-pillrounded-card, rounded-button, rounded-pill
The shadowshadow-float
The type stylestext-display to text-label: the size, the line height, the weight and the tracking together
The sizes of controlsh-hit, h-control-md, size-control-lg, size-icon
The spaces of a layoutp-card, px-gutter, gap-grid, py-section
--container and --measuremax-w-page, max-w-measure
The breakpointsphone:, tablet:, bento: and header:
The dark themesdark:
  • The theme still works. Each utility reads the system's own custom property: bg-page is var(--page). So data-theme on <html>, or on any element, changes the utilities the way it changes the components.
  • Dark follows the theme, not the system setting. dark: applies inside any of the dark themes.
  • Spacing needs nothing. Tailwind's spacing scale (p-1 is 4px, p-4 is 16px) is already the system's own.
  • Tailwind's palette stays. To use only the system's colours, put @theme { --color-*: initial; } before the import.

Tailwind CSS 3

Add tailwind/preset.cjs as a preset, and link tokens.css on the page:

JavaScript
// tailwind.config.js
module.exports = {
  presets: [require('./tailwind/preset.cjs')],
  content: ['./src/**/*.html'],
};

The names are the same as in version 4. Version 3 also gets z-float, z-toast, duration-press and ease-tray.

It does not get the breakpoints: Tailwind 3 adds new ones after its own, out of order. Write min-[34rem]: for the width at which the system's layouts change.

Figma

The variables come in the Design Tokens format that Figma imports, with one file per theme:

  1. In Figma, open the variables of the file and create a collection named Colours.
  2. Drop in the ten files of figma/colours/, from Light to Espresso. Each file becomes a mode of the collection, so a frame switches theme the way a page does.
  3. Create a second collection and drop in Scale.tokens.json: the space, the corners, the sizes, the type sizes and weights, the durations and the layers.

A variable has the name the token has in code. The colour ink-soft is --ink-soft, and the scale variable radius/card is --radius-card. Each variable's description gives its CSS name and what it is for.

  • Sizes are in px. Figma takes px only, so rem is counted at 16px and a fluid size takes its largest value.
  • The shadow and the easing are not included. Figma has no variable for them: draw the shadow as an effect style from --shadow-float.
  • A paid Figma plan is needed. Figma's help says importing variables needs a Professional plan or above.
  • To update a theme, import its file again. Right-click its mode and choose Import mode: variables with the same name and type change in place.

The ten colour files and the scale are also in the figma folder of the download.

↑↓ to moveEnter to openEsc to close