# Typography

> Apply Honest UI's font-family, weight, body, title, and technical-text tokens with readable pairings.

Source: https://www.honestui.com/docs/theme/typography

Honest UI separates typography into family roles and coordinated scales. Each size has a matching line height and letter spacing value, so text remains consistent across component labels, body copy, headings, and technical content.

The default family resolves through `--font-love-sans` and falls back to Arial, then the system sans-serif. You can load LoveSans in your application or point `--font-love-sans` at a typeface you already own.

## Font families [#font-families]

<TokenTable
  caption="Honest UI font-family tokens"
  type="typography"
  tokens="[
  { name: &#x22;--hui-font-love-sans&#x22;, value: &#x22;var(--font-love-sans), Arial, sans-serif&#x22;, description: &#x22;Shared family stack and customization point&#x22; },
  { name: &#x22;--hui-font-title&#x22;, value: &#x22;var(--hui-font-love-sans)&#x22;, description: &#x22;Headings and display titles&#x22; },
  { name: &#x22;--hui-font-body&#x22;, value: &#x22;var(--hui-font-love-sans)&#x22;, description: &#x22;Body copy, controls, labels, and supporting text&#x22; },
  { name: &#x22;--hui-font-mono&#x22;, value: &#x22;var(--hui-font-love-sans)&#x22;, description: &#x22;Technical-text role; override it when true monospaced alignment is required&#x22; },
]"
/>

Titles and body copy use the same family. Controls use a 14px label size (`--hui-font-size-control`), with 13px for small controls and 12px for extra-small ones.

To provide an application font without changing component code:

```css
:root {
  --font-love-sans: "Your Product Sans";
  --hui-font-mono: "Your Product Mono", ui-monospace, monospace;
}
```

If character alignment matters—for code, tabular output, or logs—do not assume the default `--hui-font-mono` value is monospaced. Override the role with a real monospace family and test the content you display.

## Font weights [#font-weights]

<TokenTable
  caption="Honest UI font-weight tokens"
  type="typography"
  tokens="[
  { name: &#x22;--hui-font-weight-regular&#x22;, value: &#x22;400&#x22;, description: &#x22;Body copy, descriptions, and most control text&#x22; },
  { name: &#x22;--hui-font-weight-medium&#x22;, value: &#x22;500&#x22;, description: &#x22;Labels, headings, and moderate emphasis&#x22; },
  { name: &#x22;--hui-font-weight-semibold&#x22;, value: &#x22;600&#x22;, description: &#x22;Strong labels and compact structural emphasis&#x22; },
]"
/>

Load every weight you use. Honest UI disables synthetic bold and italic through `font-synthesis: none`, so a missing face will not be fabricated by the browser.

## Body scale [#body-scale]

Use the three tokens for a named step together. The `base` aliases point to the regular body step and are useful where a component needs the default without repeating its specific size name.

<TokenTable
  caption="Honest UI body font-size tokens"
  type="typography"
  tokens="[
  { name: &#x22;--hui-font-size-micro&#x22;, value: &#x22;10px&#x22;, description: &#x22;Dense metadata and short supporting labels&#x22; },
  { name: &#x22;--hui-font-size-mini&#x22;, value: &#x22;11px&#x22;, description: &#x22;Captions, badges, and compact field help&#x22; },
  { name: &#x22;--hui-font-size-small&#x22;, value: &#x22;12px&#x22;, description: &#x22;Secondary text, labels, and compact controls&#x22; },
  { name: &#x22;--hui-font-size-control&#x22;, value: &#x22;14px&#x22;, description: &#x22;Text inside controls: button labels, field values, and tabs&#x22; },
  { name: &#x22;--hui-font-size-regular&#x22;, value: &#x22;14px&#x22;, description: &#x22;Default component and body text&#x22; },
  { name: &#x22;--hui-font-size-large&#x22;, value: &#x22;16px&#x22;, description: &#x22;Prominent body copy and large controls&#x22; },
  { name: &#x22;--hui-font-size-base&#x22;, value: &#x22;var(--hui-font-size-regular)&#x22;, description: &#x22;Alias for the default body size&#x22; },
]"
/>

<TokenTable
  caption="Honest UI body line-height tokens"
  type="typography"
  tokens="[
  { name: &#x22;--hui-line-height-micro&#x22;, value: &#x22;12px&#x22;, description: &#x22;Line height paired with micro text&#x22; },
  { name: &#x22;--hui-line-height-mini&#x22;, value: &#x22;14px&#x22;, description: &#x22;Line height paired with mini text&#x22; },
  { name: &#x22;--hui-line-height-small&#x22;, value: &#x22;16px&#x22;, description: &#x22;Line height paired with small text&#x22; },
  { name: &#x22;--hui-line-height-control&#x22;, value: &#x22;16px&#x22;, description: &#x22;Line height paired with control text&#x22; },
  { name: &#x22;--hui-line-height-regular&#x22;, value: &#x22;20px&#x22;, description: &#x22;Line height paired with regular text&#x22; },
  { name: &#x22;--hui-line-height-large&#x22;, value: &#x22;24px&#x22;, description: &#x22;Line height paired with large text&#x22; },
  { name: &#x22;--hui-line-height-base&#x22;, value: &#x22;var(--hui-line-height-regular)&#x22;, description: &#x22;Alias for the default body line height&#x22; },
]"
/>

<TokenTable
  caption="Honest UI body letter-spacing tokens"
  type="typography"
  tokens="[
  { name: &#x22;--hui-letter-spacing-micro&#x22;, value: &#x22;0.01em&#x22;, description: &#x22;Tracking paired with micro text&#x22; },
  { name: &#x22;--hui-letter-spacing-mini&#x22;, value: &#x22;0.005em&#x22;, description: &#x22;Tracking paired with mini text&#x22; },
  { name: &#x22;--hui-letter-spacing-small&#x22;, value: &#x22;0em&#x22;, description: &#x22;Tracking paired with small text&#x22; },
  { name: &#x22;--hui-letter-spacing-control&#x22;, value: &#x22;0&#x22;, description: &#x22;Tracking paired with control text&#x22; },
  { name: &#x22;--hui-letter-spacing-regular&#x22;, value: &#x22;-0.006em&#x22;, description: &#x22;Tracking paired with regular text&#x22; },
  { name: &#x22;--hui-letter-spacing-large&#x22;, value: &#x22;-0.011em&#x22;, description: &#x22;Tracking paired with large text&#x22; },
  { name: &#x22;--hui-letter-spacing-base&#x22;, value: &#x22;var(--hui-letter-spacing-regular)&#x22;, description: &#x22;Alias for the default body tracking&#x22; },
]"
/>

## Title scale [#title-scale]

The four title steps map to the global `h4` through `h1` styles included by Honest UI. Those selectors use the title family, medium weight, the matching line height, and balanced wrapping.

<TokenTable
  caption="Honest UI title typography tokens"
  type="typography"
  tokens="[
  { name: &#x22;--hui-font-size-t1&#x22;, value: &#x22;20px&#x22;, description: &#x22;Small heading size; used by h4&#x22; },
  { name: &#x22;--hui-line-height-t1&#x22;, value: &#x22;28px&#x22;, description: &#x22;Line height paired with t1&#x22; },
  { name: &#x22;--hui-letter-spacing-t1&#x22;, value: &#x22;-0.01em&#x22;, description: &#x22;Tracking paired with t1&#x22; },
  { name: &#x22;--hui-font-size-t2&#x22;, value: &#x22;24px&#x22;, description: &#x22;Section heading size; used by h3&#x22; },
  { name: &#x22;--hui-line-height-t2&#x22;, value: &#x22;32px&#x22;, description: &#x22;Line height paired with t2&#x22; },
  { name: &#x22;--hui-letter-spacing-t2&#x22;, value: &#x22;-0.013em&#x22;, description: &#x22;Tracking paired with t2&#x22; },
  { name: &#x22;--hui-font-size-t3&#x22;, value: &#x22;28px&#x22;, description: &#x22;Page-section heading size; used by h2&#x22; },
  { name: &#x22;--hui-line-height-t3&#x22;, value: &#x22;36px&#x22;, description: &#x22;Line height paired with t3&#x22; },
  { name: &#x22;--hui-letter-spacing-t3&#x22;, value: &#x22;-0.016em&#x22;, description: &#x22;Tracking paired with t3&#x22; },
  { name: &#x22;--hui-font-size-t4&#x22;, value: &#x22;32px&#x22;, description: &#x22;Page-title size; used by h1&#x22; },
  { name: &#x22;--hui-line-height-t4&#x22;, value: &#x22;40px&#x22;, description: &#x22;Line height paired with t4&#x22; },
  { name: &#x22;--hui-letter-spacing-t4&#x22;, value: &#x22;-0.02em&#x22;, description: &#x22;Tracking paired with t4&#x22; },
]"
/>

## Technical-text scale [#technical-text-scale]

The technical scale supplies size, line-height, and tracking pairs. Apply `--hui-font-mono` separately because these tokens do not set the family.

<TokenTable
  caption="Honest UI technical-text typography tokens"
  type="typography"
  tokens="[
  { name: &#x22;--hui-font-size-mono-mini&#x22;, value: &#x22;11px&#x22;, description: &#x22;Small technical labels and timestamps&#x22; },
  { name: &#x22;--hui-line-height-mono-mini&#x22;, value: &#x22;16px&#x22;, description: &#x22;Line height paired with mono mini&#x22; },
  { name: &#x22;--hui-letter-spacing-mono-mini&#x22;, value: &#x22;0px&#x22;, description: &#x22;Tracking paired with mono mini&#x22; },
  { name: &#x22;--hui-font-size-mono-small&#x22;, value: &#x22;12px&#x22;, description: &#x22;Inline code and compact output&#x22; },
  { name: &#x22;--hui-line-height-mono-small&#x22;, value: &#x22;16px&#x22;, description: &#x22;Line height paired with mono small&#x22; },
  { name: &#x22;--hui-letter-spacing-mono-small&#x22;, value: &#x22;0px&#x22;, description: &#x22;Tracking paired with mono small&#x22; },
  { name: &#x22;--hui-font-size-mono-regular&#x22;, value: &#x22;14px&#x22;, description: &#x22;Default code blocks and technical output&#x22; },
  { name: &#x22;--hui-line-height-mono-regular&#x22;, value: &#x22;20px&#x22;, description: &#x22;Line height paired with mono regular&#x22; },
  { name: &#x22;--hui-letter-spacing-mono-regular&#x22;, value: &#x22;0px&#x22;, description: &#x22;Tracking paired with mono regular&#x22; },
  { name: &#x22;--hui-font-size-mono-large&#x22;, value: &#x22;16px&#x22;, description: &#x22;Prominent technical output&#x22; },
  { name: &#x22;--hui-line-height-mono-large&#x22;, value: &#x22;24px&#x22;, description: &#x22;Line height paired with mono large&#x22; },
  { name: &#x22;--hui-letter-spacing-mono-large&#x22;, value: &#x22;0px&#x22;, description: &#x22;Tracking paired with mono large&#x22; },
]"
/>

## Tailwind usage [#tailwind-usage]

Use arbitrary properties for the complete type recipe. This avoids ambiguity between Tailwind's text-color and font-size utilities:

```tsx
<section>
  <p
    className="
      [font-family:var(--hui-font-body)]
      [font-size:var(--hui-font-size-small)]
      [font-weight:var(--hui-font-weight-medium)]
      [letter-spacing:var(--hui-letter-spacing-small)]
      [line-height:var(--hui-line-height-small)]
    "
  >
    Monthly revenue
  </p>
  <p
    className="
      [font-family:var(--hui-font-title)]
      [font-size:var(--hui-font-size-t3)]
      [font-weight:var(--hui-font-weight-medium)]
      [letter-spacing:var(--hui-letter-spacing-t3)]
      [line-height:var(--hui-line-height-t3)]
    "
  >
    $42,180
  </p>
</section>
```

For Tailwind v4 shorthand, use a type hint when needed: `text-(length:--hui-font-size-regular)` sets font size, while `text-(color:--hui-color-foreground-base-primary)` sets color.

## Readability checks [#readability-checks]

* Keep body copy at a readable size for its context; micro and mini steps are for short supporting text, not long instructions.
* Pair each size with its named line height and letter spacing instead of mixing steps casually.
* Do not encode heading structure with size alone. Use semantic heading levels in a logical order, then style them.
* Let text wrap. Avoid fixed heights on labels, buttons, and fields that break when text is enlarged or translated.
* Test at 200% and 400% zoom, with browser text-spacing overrides, and with long unbroken content.
* Use real text rather than text baked into an image, and maintain at least the contrast required by the product's accessibility target.
