Pre-alphaThe registry and the CLI are not published yet.Roadmap

Typography

The type scale, from 34 down to 12.

Draft

The values shown here are conceptual and may change.

Each style sets a font size, a line height, a weight and a font family together. The names and sizes follow the iOS text styles. Display styles carry negative letterSpacing, so headings stay tight at large sizes; body styles leave it at zero.

largeTitle
Your changes are saved
34/40 · 800
title1
Your changes are saved
28/33 · 800
title2
Your changes are saved
22/27 · 700
title3
Your changes are saved
20/25 · 700
headline
Your changes are saved
17/22 · 600
body
Your changes are saved
17/23 · 400
callout
Your changes are saved
16/21 · 400
subheadline
Your changes are saved
15/20 · 400
footnote
Your changes are saved
13/18 · 500
caption
Your changes are saved
12/16 · 500

Two fonts cover the whole scale: heading for titles, body for everything else. undefined keeps the system font.

Conceptual
export const fonts: Fonts = {
	heading: undefined,
	body: undefined,
};

export const typography = {
	largeTitle: {
		fontSize: 34,
		lineHeight: 40,
		fontWeight: "800",
		letterSpacing: -0.8,
		fontFamily: fonts.heading,
	},
	title1: { /* … */ fontFamily: fonts.heading },
	title2: { /* … */ fontFamily: fonts.heading },
	title3: { /* … */ fontFamily: fonts.heading },
	headline: { /* … */ fontFamily: fonts.heading },
	body: { fontSize: 17, lineHeight: 23, fontWeight: "400", fontFamily: fonts.body },
	callout: { fontSize: 16, lineHeight: 21, fontWeight: "400" },
	subheadline: { fontSize: 15, lineHeight: 20, fontWeight: "400" },
	footnote: { fontSize: 13, lineHeight: 18, fontWeight: "500" },
	caption: { fontSize: 12, lineHeight: 16, fontWeight: "500" },
} satisfies Typography;

Usage

Title and Text map their props onto these styles, so you rarely read them directly:

Conceptual
<Title level={1}>Settings</Title> // largeTitle
<Text>Saved automatically.</Text> // body

Custom fonts

Load the fonts with expo-font, then set their names in fonts:

theme/tokens.ts
export const fonts: Fonts = {
	heading: "Fraunces_600SemiBold",
	body: "Inter_400Regular",
};

largeTitle to headline use heading; body to caption use body. Every component reads the typography styles, so the change reaches them all.

A font file holds a single weight on Android. When a family has one file per weight, the fontWeight of a style does not switch files: pick the file that matches the weight you want most, or give a style its own fontFamily.

On this page