Typography Tokens

This page covers Lism’s typography design tokens: font-family, font-size, line-height, and more.

FF: font-family

Tokens for font-family.

Token	Variable	Class
`base`	`--ff--base`	`-ff:base`
`accent`	`--ff--accent`	`-ff:accent`
`mono`	`--ff--mono`	`-ff:mono`

↓

Preview

base: English text, 漢字ひらがな

accent: English text, 漢字ひらがな

mono: English text, 漢字ひらがな

<p class="-ff:base -fz:xl">Lorem ipsum ...</p>
<p class="-ff:accent -fz:xl">Lorem ipsum ...</p>
<p class="-ff:mono -fz:xl">Lorem ipsum ...</p>

This site changes --ff--base for its body text, so this preview does not show the exact default.

FW: font-weight

Tokens for font-weight.

Token	Variable	Class	Default value
`light`	`--fw--light`	`-fw:light`	`300`
`normal`	`--fw--normal`	`-fw:normal`	`400`
`bold`	`--fw--bold`	`-fw:bold`	`600`

Numeric classes -fw:100 through -fw:900 are also available for fine-grained weight control.

↓

Preview

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

<p class="-fw:light">Lorem ipsum ...</p>
<p class="-fw:normal">Lorem ipsum ...</p>
<p class="-fw:bold">Lorem ipsum ...</p>

<Text fw="light">Lorem ipsum ...</Text>
<Text fw="normal">Lorem ipsum ...</Text>
<Text fw="bold">Lorem ipsum ...</Text>

FZ: font-size

Tokens for font-size.

Token	Variable	Class	Default value
`base`	`--fz--base`	`-fz:base`	`1rem`
`2xs`	`--fz--2xs`	`-fz:2xs`	`1em * 8 / 11`
`xs`	`--fz--xs`	`-fz:xs`	`1em * 8 / 10`
`s`	`--fz--s`	`-fz:s`	`1em * 8 / 9`
`m`	`--fz--m`	`-fz:m`	`1em`
`l`	`--fz--l`	`-fz:l`	`1em * 8 / 7`
`xl`	`--fz--xl`	`-fz:xl`	`1em * 8 / 6`
`2xl`	`--fz--2xl`	`-fz:2xl`	`1em * 8 / 5`
`3xl`	`--fz--3xl`	`-fz:3xl`	`1em * 8 / 4`
`4xl`	`--fz--4xl`	`-fz:4xl`	`1em * 8 / 3`
`5xl`	`--fz--5xl`	`-fz:5xl`	`1em * 8 / 2`

↓

Preview

2xs

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

xs

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

s

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

base

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

l

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

xl

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

2xl

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

3xl

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

4xl

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

5xl

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

<p class="-fz:2xs">Lorem ipsum ...</p>
<p class="-fz:xs">Lorem ipsum ...</p>
<p class="-fz:s">Lorem ipsum ...</p>
<p class="-fz:m">Lorem ipsum ...</p>
<p class="-fz:base">Lorem ipsum ...</p>
<p class="-fz:l">Lorem ipsum ...</p>
<p class="-fz:xl">Lorem ipsum ...</p>
<p class="-fz:2xl">Lorem ipsum ...</p>
<p class="-fz:3xl">Lorem ipsum ...</p>
<p class="-fz:4xl">Lorem ipsum ...</p>

Font Size Scaling Rules

Lism scales font sizes using a harmonic series — a progression valued for both its mathematical and musical elegance.

Reference: On typography and spacing scaling design

This approach — sometimes called harmonic modular scaling — is also covered in resources like Every Layout.

By default, Lism CSS uses the harmonic series with numerator 8 as its scale.

On this documentation site, --fz-mol is set to 7 for English pages.

:root {
  --fz-mol: 8;
  --fz--5xl: calc(1em * var(--fz-mol) / (var(--fz-mol) - 6));
  --fz--4xl: calc(1em * var(--fz-mol) / (var(--fz-mol) - 5));
  --fz--3xl: calc(1em * var(--fz-mol) / (var(--fz-mol) - 4));
  --fz--2xl: calc(1em * var(--fz-mol) / (var(--fz-mol) - 3));
  --fz--xl: calc(1em * var(--fz-mol) / (var(--fz-mol) - 2));
  --fz--l: calc(1em * var(--fz-mol) / (var(--fz-mol) - 1));
  --fz--m: 1em;
  --fz--s: calc(1em * var(--fz-mol) / (var(--fz-mol) + 1));
  --fz--xs: calc(1em * var(--fz-mol) / (var(--fz-mol) + 2));
  --fz--2xs: calc(1em * var(--fz-mol) / (var(--fz-mol) + 3));
}

HL: half-leading

Lism CSS takes a distinctive approach to line-height, managing it on every element through half-leading values (the spacing on each side, above and below, of a line): line-height is computed from the --hl variable.

The following tokens are available for --hl.

Token	Variable	Class	Default value
`xs`	`--hl--xs`	`-hl:xs`	`var(--hl-unit)`
`s`	`--hl--s`	`-hl:s`	`calc(var(--hl-unit) * 2)`
`base`	`--hl--base`	`-hl:base`	`calc(var(--hl-unit) * 3)`
`l`	`--hl--l`	`-hl:l`	`calc(var(--hl-unit) * 4)`
`xl`	`--hl--xl`	`-hl:xl`	`calc(var(--hl-unit) * 5)`

--hl-unit defaults to 0.125rem (≈ 2px).

↓

Preview

0: Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut. Labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut.

xs: Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut. Labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut.

s: Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut. Labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut.

base: Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut. Labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut.

l: Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut. Labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut.

xl: Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut. Labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut.

<p class="-hl:xs">Lorem ipsum ...</p>
<p class="-hl:s">Lorem ipsum ...</p>
<p class="-hl:base">Lorem ipsum ...</p>
<p class="-hl:l">Lorem ipsum ...</p>
<p class="-hl:xl">Lorem ipsum ...</p>

<Text hl="xs">Lorem ipsum ...</Text>
<Text hl="s">Lorem ipsum ...</Text>
<Text hl="base">Lorem ipsum ...</Text>
<Text hl="l">Lorem ipsum ...</Text>
<Text hl="xl">Lorem ipsum ...</Text>

For the design rationale, see Half-Leading (line-height).

Half-Leading (line-height)

How and why Lism CSS manages line-height through half-leading values.

LH: line-height

Tokens for --lh, which sets line-height as a ratio of the font size. Use them when line spacing should scale with the font size.

Token	Variable	Class	Default value
`xs`	`--lh--xs`	`-lh:xs`	`1.25`
`s`	`--lh--s`	`-lh:s`	`1.5`
`m`	`--lh--m`	`-lh:m`	`1.75`
`l`	`--lh--l`	`-lh:l`	`2`
`xl`	`--lh--xl`	`-lh:xl`	`2.25`

Each value matches the default hl scale at the base font size (1rem).

↓

Preview

1: Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut. Labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut.

m: Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut. Labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut.

<p class="-lh:xs">Lorem ipsum ...</p>
<p class="-lh:s">Lorem ipsum ...</p>
<p class="-lh:m">Lorem ipsum ...</p>
<p class="-lh:l">Lorem ipsum ...</p>
<p class="-lh:xl">Lorem ipsum ...</p>

<Text lh="xs">Lorem ipsum ...</Text>
<Text lh="s">Lorem ipsum ...</Text>
<Text lh="m">Lorem ipsum ...</Text>
<Text lh="l">Lorem ipsum ...</Text>
<Text lh="xl">Lorem ipsum ...</Text>

For when to use hl vs lh, see Half-Leading (line-height).

LTS: letter-spacing

Tokens for letter-spacing.

Token	Variable	Class	Default value
`base`	`--lts--base`	`-lts:base`	`0em`
`xs`	`--lts--xs`	`-lts:xs`	`calc(var(--lts--base) - 0.05em)`
`s`	`--lts--s`	`-lts:s`	`calc(var(--lts--base) - 0.025em)`
`l`	`--lts--l`	`-lts:l`	`calc(var(--lts--base) + 0.05em)`
`xl`	`--lts--xl`	`-lts:xl`	`calc(var(--lts--base) + 0.1em)`

--lts--base must be a length (normal cannot be used because the value goes into calc()). xs to xl are offsets from --lts--base, so changing --lts--base on :root shifts all of them. Overriding --lts--base on a descendant element does not affect xs to xl.

↓

Preview

xs

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

s

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

base

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

l

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

xl

Lorem ipsum dolor sit amet. Consectetur adipiscing elit, sed do eiusmod tempor Incididunt ut.

<p class="-lts:s">Lorem ipsum ...</p>
<p class="-lts:base">Lorem ipsum ...</p>
<p class="-lts:l">Lorem ipsum ...</p>

<Text lts="s">Lorem ipsum ...</Text>
<Text lts="base">Lorem ipsum ...</Text>
<Text lts="l">Lorem ipsum ...</Text>

This site slightly adjusts --ff--base and --lts--base for its body text, so this preview does not show the exact defaults.