design token

Text Styles

Predefined typography compositions for consistent text rendering across all components and frameworks.

Predefined typography compositions that bundle font size, weight, letter spacing, and line height into a single textStyle property.

Headings

One scale for every title. The large steps are expressive (tight tracking + leading) and fluidheading.lg, heading.xl, and heading.2xl use a clamp() generated from the type scale, so they scale between 360px and 1280px viewports. The small steps (heading.xsheading.3xs) are compact semibold headers for cards, banners, and dense components.

scale · headings
heading.2xlAa Bb 01 23
fontsanssizefluidweightboldleadingxtighttrackingtight
heading.xlAa Bb 01 23
fontsanssizefluidweightboldleadingxtighttrackingtight
heading.lgAa Bb 01 23
fontsanssizefluidweightboldleadingxtighttrackingtight
heading.mdAa Bb 01 23
fontsanssize2xlweightboldleadingsnugtrackingsnug
heading.smAa Bb 01 23
fontsanssizexlweightsemiboldleadingsnugtrackingnormal
heading.xsAa Bb 01 23
fontsanssizelgweightsemiboldleadingsnugtrackingnormal
heading.2xsAa Bb 01 23
fontsanssizemdweightsemiboldleadingsnugtrackingnormal
heading.3xsAa Bb 01 23
fontsanssizesmweightsemiboldleadingsnugtrackingnormal

Body

scale · body
leadAa Bb 01 23
fontsanssizefluidweightnormalleadingrelaxedtrackingnormal
body.lgAa Bb 01 23
fontsanssizelgweightnormalleadingnormaltrackingnormal
body.mdAa Bb 01 23
fontsanssizemdweightnormalleadingnormaltrackingnormal
body.smAa Bb 01 23
fontsanssizesmweightnormalleadingnormaltrackingnormal

Labels

scale · labels
label.lgAa Bb 01 23
fontsanssizemdweightmediumleadingsnugtrackingnormal
label.mdAa Bb 01 23
fontsanssizesmweightmediumleadingsnugtrackingnormal
label.smAa Bb 01 23
fontsanssizexsweightmediumleadingsnugtrackingnormal

Numeric

Tabular figures for currency, counts, percentages, and KPIs. font-variant-numeric: tabular-nums keeps digits aligned and stops them jittering as values update, and lining-nums pins them to cap height in case the face ships oldstyle numerals by default.

numeric.xs is the small end of the set — body-sized figures that sit inline with UI text (table cells, pagination counts, timers, progress readouts) rather than headlining a card.

scale · numeric
numeric.lgAa Bb 01 23
fontsanssize4xlweightboldleadingxtighttrackingtighter
numeric.mdAa Bb 01 23
fontsanssize3xlweightboldleadingxtighttrackingtight
numeric.smAa Bb 01 23
fontsanssize2xlweightboldleadingxtighttrackingtight
numeric.xsAa Bb 01 23
fontsanssizesmweightmediumleadingsnugtrackingnormal

Control

Per-size typography for interactive labels (buttons, inputs, badges). These mirror the sizing pattern’s font scale and carry no weight of their own — each control keeps its own.

scale · control
control.xlAa Bb 01 23
fontsanssizelgweightinheritleadingnonetrackingnormal
control.lgAa Bb 01 23
fontsanssizemdweightinheritleadingnonetrackingnormal
control.mdAa Bb 01 23
fontsanssizesmweightinheritleadingnonetrackingnormal
control.smAa Bb 01 23
fontsanssizexsweightinheritleadingnonetrackingnormal
control.xsAa Bb 01 23
fontsanssizexsweightinheritleadingnonetrackingnormal

Special

scale · special
captionAa Bb 01 23
fontsanssizexsweightnormalleadingnormaltrackingnormal
eyebrowAa Bb 01 23
fontmonosizexsweightmediumleadingsnugtrackingwide
codeAa Bb 01 23
fontmonosize0.9375emweightnormalleadingsnugtrackingnormal
kbdAa Bb 01 23
fontmonosizexsweightmediumleadingnonetrackingnormal
quoteAa Bb 01 23
fontsanssizefluidweightnormalleadingrelaxedtrackingnormal

Usage

import { css } from "@pindoba/styled-system/css";

<h1 className={css({ textStyle: "heading.2xl" })}>Hero Heading</h1>
<h2 className={css({ textStyle: "heading.md" })}>Section Title</h2>
<p className={css({ textStyle: "body.md" })}>Paragraph text</p>
<strong className={css({ textStyle: "numeric.lg" })}>R$ 12,840.55</strong>
<label className={css({ textStyle: "label.md" })}>Form Label</label>
<code className={css({ textStyle: "code" })}>npm install</code>

Responsive text styles

heading.lg, heading.xl, and heading.2xl are already fluid (clamp()), so they scale automatically. For discrete per-breakpoint steps you can also vary the token at the usage site:

<h1
  className={css({
    textStyle: { base: "heading.md", md: "heading.lg", lg: "heading.2xl" },
  })}
>
  Responsive heading
</h1>

Best Practices

  • Use textStyle instead of setting fontSize, fontWeight, and lineHeight individually
  • Maintain hierarchy: heading > body > label > special
  • Reach for numeric.* for any prominent figure (currency, stats, counts) so digits stay tabular
  • The large headings are fluid out of the box; only reach for usage-site responsive steps when you need discrete jumps