Typography | CombricSkip to content

Typography

Combric

Typography is system-first by default. Heading roles combine size, tight line height, emphasis, and restrained tracking without requiring a web font. This documentation site keeps that default and does not import @combric/fonts.

Optional Fontsource preset

Consumer applications can opt into the official Fontsource preset when they want its self-hosted variable-font defaults:

Install the optional preset
npm install @combric/fonts@1.5.1

Import the preset last, after every other Combric stylesheet used by the application. It reassigns the typography primitives after token imports:

src/styles/combric-fontsource.css
@import "@combric/react/css";
@import "@combric/menu/css";
/* Import any other Combric CSS before the preset. */
@import "@combric/fonts/css";

The preset uses Fontsource to emit self-hosted WOFF2 assets for Inter Variable and JetBrains Mono Variable. Its sans fallback is "Inter Variable", Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, sans-serif; its monospace fallback starts with "JetBrains Mono Variable", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace. The bundled faces use font-display: swap, so verify the intended FOUT and layout stability in the consumer build. The preset supplies normal variable faces; add an explicit italic face if a product needs one.

Local, Google, Adobe, or another provider

Choose one provider path. For a local font, Google Fonts, Adobe Fonts, or any other provider, omit the preset and override both primitives after the Combric CSS. This avoids ambiguous family names, duplicate requests, and unnecessary Fontsource assets:

src/styles/combric-brand-fonts.css
@import "@combric/react/css";
/* Leave out: @import "@combric/fonts/css"; */
@font-face {
font-family: "Brand Sans";
src: url("/fonts/brand-sans.woff2") format("woff2");
font-display: swap;
}
:root {
--combric-primitive-font-family-sans:
"Brand Sans", ui-sans-serif, system-ui, sans-serif;
--combric-primitive-font-family-mono:
"Brand Mono", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

For Google Fonts, Adobe Fonts, or another hosted provider, load only that provider’s approved stylesheet or embed method, then apply the same two primitive overrides in your application CSS. Check the provider licence, privacy terms, Content Security Policy, cache policy, and the MIME type for locally served WOFF2 assets. Do not combine a provider face named Inter Variable or JetBrains Mono Variable with @combric/fonts unless duplicated assets are an intentional product decision.

KindTokenValue / referenceCSS variable
Primitivefont.family.monoui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace--combric-primitive-font-family-mono
Primitivefont.family.sansInter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, sans-serif--combric-primitive-font-family-sans
Primitivefont.size.2xl2rem--combric-primitive-font-size-2xl
Primitivefont.size.lg1.25rem--combric-primitive-font-size-lg
Primitivefont.size.md1rem--combric-primitive-font-size-md
Primitivefont.size.sm0.875rem--combric-primitive-font-size-sm
Primitivefont.size.xl1.5rem--combric-primitive-font-size-xl
Primitivefont.size.xs0.75rem--combric-primitive-font-size-xs
Primitivefont.weight.bold700--combric-primitive-font-weight-bold
Primitivefont.weight.medium500--combric-primitive-font-weight-medium
Primitivefont.weight.regular400--combric-primitive-font-weight-regular
Primitivefont.weight.semibold600--combric-primitive-font-weight-semibold
Primitiveletter.spacing.normal0--combric-primitive-letter-spacing-normal
Primitiveletter.spacing.tight-0.01em--combric-primitive-letter-spacing-tight
Primitiveline.height.body1.5--combric-primitive-line-height-body
Primitiveline.height.relaxed1.65--combric-primitive-line-height-relaxed
Primitiveline.height.tight1.2--combric-primitive-line-height-tight
Semanticfont.family.bodyfont.family.sans → Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, sans-serif--combric-font-family-body
Semanticfont.family.codefont.family.mono → ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace--combric-font-family-code
Semanticfont.size.bodyfont.size.md → 1rem--combric-font-size-body
Semanticfont.size.heading.lgfont.size.2xl → 2rem--combric-font-size-heading-lg
Semanticfont.size.heading.mdfont.size.xl → 1.5rem--combric-font-size-heading-md
Semanticfont.size.heading.smfont.size.lg → 1.25rem--combric-font-size-heading-sm
Semanticfont.size.smallfont.size.sm → 0.875rem--combric-font-size-small
Semanticfont.weight.bodyfont.weight.regular → 400--combric-font-weight-body
Semanticfont.weight.emphasisfont.weight.semibold → 600--combric-font-weight-emphasis
Semanticletter.spacing.headingletter.spacing.tight → -0.01em--combric-letter-spacing-heading
Semanticline.height.bodyline.height.body → 1.5--combric-line-height-body
Semanticline.height.headingline.height.tight → 1.2--combric-line-height-heading