Skip to content
Browse documentation
whisk/ui

Typography

Use the shared type scale, font weights, line heights, tracking, and text styles to create a clear hierarchy.

Choose a text role

Choose a semantic heading level for document structure, then apply a shared text style for visual hierarchy. Use body for reading copy, caption for short component text, and Code for technical values.

Project activity

Review the latest work across your project.

import { Heading, Text } from "@smoothie-framework/whisk-react";

<Heading level={2} textStyle="h3">Project activity</Heading>
<Text textStyle="body" color="subtle">
  Review the latest work across your project.
</Text>

Fonts

Choose body for reading, heading for hierarchy, and mono for technical values.

heading

Ag

body

Ag

mono

Ag

Font sizes

Use the shared scale to create visual emphasis without changing semantic structure.

2xs

0.625rem

Aa

xs

0.75rem

Aa

sm

0.875rem

Aa

md

1rem

Aa

lg

1.125rem

Aa

xl

1.25rem

Aa

2xl

1.5rem

Aa

3xl

1.875rem

Aa

4xl

2.25rem

Aa

5xl

3rem

Aa

6xl

3.75rem

Aa

7xl

4.5rem

Aa

8xl

6rem

Aa

9xl

8rem

Aa

Font weights

Increase weight for emphasis, not as a replacement for hierarchy or contrast.

thin

100

Aa

light

300

Aa

normal

400

Aa

medium

500

Aa

semibold

600

Aa

bold

700

Aa

extrabold

800

Aa

Line heights

Use more leading for reading copy and tighter leading for short display text.

shorter

1.25

A good smoothie takes a bunch of ingredients that have no business being together, fruit, ice, maybe some spinach if you're that person, and blends them into something that just works.

short

1.375

A good smoothie takes a bunch of ingredients that have no business being together, fruit, ice, maybe some spinach if you're that person, and blends them into something that just works.

moderate

1.5

A good smoothie takes a bunch of ingredients that have no business being together, fruit, ice, maybe some spinach if you're that person, and blends them into something that just works.

tall

1.625

A good smoothie takes a bunch of ingredients that have no business being together, fruit, ice, maybe some spinach if you're that person, and blends them into something that just works.

taller

2

A good smoothie takes a bunch of ingredients that have no business being together, fruit, ice, maybe some spinach if you're that person, and blends them into something that just works.

Letter spacings

Keep tracking at its default for reading copy and change it only when the text role needs it.

tighter

-0.05em

Smoothie Framework

tight

-0.025em

Smoothie Framework

normal

0em

Smoothie Framework

wide

0.025em

Smoothie Framework

wider

0.05em

Smoothie Framework

widest

0.1em

Smoothie Framework

TextStyle

Text styles apply a shared visual composition while the element keeps its semantic role.

display

Whisk/UI

h1

Whisk/UI

h2

Whisk/UI

h3

Whisk/UI

body

Whisk/UI

body-sm

Whisk/UI

caption

Whisk/UI

code

Whisk/UI

Readable product copy.

STATUS

import { Text } from "@smoothie-framework/whisk-react";

<Text textStyle="body">Readable product copy.</Text>
<Text textStyle="caption" color="subtle">STATUS</Text>

Keep text readable

  • Use body text for longer passages and labels for short component text.
  • Keep visible text and its background at a readable contrast in every theme.
  • Do not use visual size to replace a logical heading hierarchy.

Props

PropTypeDefaultDescription
fontFamilyFontTokenbody / heading / monoChoose the family for reading, headings, or technical text.
sizeTypographySizemdChoose the visual scale without changing the semantic host.
weightTypographyWeightnormalAdjust emphasis while keeping the same text role.
lineHeightLineHeightTokentheme valueKeep paragraph rhythm consistent.
letterSpacingLetterSpacingTokentheme valueControl tracking without writing custom CSS.
textStyleTextStylenoneApply a reusable typography composition.