Typography¶
Tomoda uses Bricolage Grotesque exclusively. It's a neutral, highly-legible sans-serif designed for UI; its calm, even rhythm keeps the focus on user-generated content while letting the brand's display sizes carry editorial weight.
The single typeface¶
Loaded once in frontend/app/_layout.tsx via @expo-google-fonts/bricolage-grotesque:
const [_fontsLoaded] = useFonts({
BricolageGrotesque_400Regular,
BricolageGrotesque_500Medium,
BricolageGrotesque_600SemiBold,
BricolageGrotesque_700Bold,
BricolageGrotesque_800ExtraBold,
});
Don't reference the font-family strings directly in styles. Import the FONT map from frontend/constants/Typography.ts and spread a face, ...FONT.semibold (etc.), so every call site stays in sync if the typeface ever changes.
Bricolage Grotesque only covers Latin, so Japanese, Chinese, Korean, Thai, Arabic, Hebrew, Devanagari, Cyrillic and Greek text renders in a fallback font. The fallback has to be asked for the same weight:
- Web:
FONTcarriesfontWeightnext tofontFamily, andapp/_layout.tsxredeclares each face at its real weight, so the browser picks the face without synthetic bolding and asks the fallback for the same weight. - Native:
FONTisfontFamilyonly. Android takes the weight from the face itself and matches fallbacks at it. A numericfontWeightnext to a custom face makes Android look for a separate bold file and drop to the system font, so never add one.
The scale¶
We don't have a long heading scale. Five named roles cover every product surface today — display for editorial moments, headline for section starts, body for content, label for metadata, mono only inside developer-facing UI.
How to pick a role¶
| Use | Role |
|---|---|
| App-shell heroes, landing splashes | display-lg or display-md |
| Tab headers, section titles | headline-lg |
| Card titles, modal headers | headline-md |
| Chat messages, event descriptions, bios | body-lg |
| List items, helpers, button labels | body-md |
| Time, status pills, category tags | label-md / label-sm |
Letter-spacing rules¶
Letter-spacing is half the design. Three principles:
- Display tightens (
-0.015emto-0.02em) — large type reads as airy by default; tightening makes it feel intentional and editorial. - Body sits at default — Bricolage Grotesque is already designed for body sizes; don't fight it.
- Labels open up (
+0.05emto+0.06em) — uppercase + open tracking signals "this is metadata, not content" and prevents short label sequences from looking cramped.
What to avoid¶
- Italic. We don't load or use an italic cut. Tomoda's voice is direct — italics read as performative emphasis or quotation, both of which we accomplish with structure instead.
- Underline for emphasis. Underline means "link." If you want emphasis, switch to
font-weight: 600(medium → semibold). - All-caps body. Reserved for
label-*. Body in all-caps reads as shouting. - Hairline weights (300 or below). Bricolage Grotesque ships an ExtraLight/Light cut; we don't load it. Below 400, the typeface loses legibility on mobile retina at body sizes.
Adding a role¶
Almost never necessary. If you genuinely need a new size (e.g. a marketing-only display), discuss before adding — every new role is a vocabulary expansion the whole team has to track. Prefer adjusting an existing role's usage over inventing a new one.
When you do add one:
- Add the role to the in-app theme (no static "type scale" file today —
makeStyles(theme)factories declare sizes inline). - Add a sample to this page in the same PR.
- If it's a marketing-only role, name it accordingly (e.g.
marketing-hero) so it's never reached for in product surfaces by mistake.