peterbamuhigire Font Selection And Pairing
Acknowledgement: Shared by Peter Bamuhigire, techguypeter.com.
Use When
- About to generate, theme, or restyle any artifact that contains type: website/landing page, DOCX/PPTX/PDF/report/proposal/business-plan/SRS, app or web UI, dashboard, or pitch deck.
- A typeface decision is needed and the work risks defaulting to an AI-slop font.
- Reviewing or refreshing an existing artifact's typography.
Do Not Use When
- The work has a binding client brand guideline that already mandates fonts - follow it, record it, and skip selection, but still apply pairing/scale hygiene.
- The task is purely embedding/loading an already-chosen font - use
font-embedding-and-licensing. - The task is auditing an existing artifact for slop - use
ai-slop-typography-audit.
Inputs
| Artefact or context | Source | Required? | Why |
|---|---|---|---|
| Artefact type, format, audience, and design voice | Brief | yes | Selects category and pairing contrast |
| Functional roles and size/device range | Product or document constraints | yes | Protects readability and hierarchy |
| Brand, script coverage, licence, and font availability | Brand and font manifests | conditional | Governs permitted implementation |
- Artifact type and output format: web, DOCX, PPTX, PDF, XLSX, UI, mobile, or app shell.
- Context and audience: formal/institutional, editorial/literary, product/grotesque, technical/data/code, friendly/humanist, expressive/artistic, script/cursive, or body/UI.
- Functional role: display, body, UI, code/data, or accent.
- Any brand constraints, and the device/size range the type must survive.
Workflow
- Classify the artifact via
doctrine/references/font-groups-and-usage.mdusing: artifact context -> design voice -> functional role -> licence/availability. - Verify the font folder taxonomy: before scanning on a new device or after a pull, ensure
the eight required
fonts/<category>/directories fromfonts/README.mdexist. Create any missing category folder without deleting or moving local font files. - Scan for premium files: run the
premium-font-scanlogic against the matchingfonts/<category>/folder. If a permitted premium family is present and would look better, prefer it; else take the named OFL baseline. - Pick a pairing using
doctrine/references/pairing-principles.md: display + body, category contrast, weight extremes, compatible x-heights, and no mood conflict. For ready, named, context-sorted pairings, usereferences/pairing-catalog.md. - State the choice before producing anything: name the display face, the body face, the category, and a one-line reason tied to this artifact's context.
- Run the anti-slop checklist below. If any item fails, fix before proceeding.
- Set the type scale per
doctrine/references/type-scale-and-spacing.md: ratio >=1.25, real jumps, inverse line-height, and weight extremes. For concrete px/rem scales, fluidclamp()versions, and variable-font axes, usereferences/type-scale-recipes.md. - Hand off to
font-embedding-and-licensingfor the format-correct load/embed.
Decision Rules
| Condition | Action | Wrong-choice failure |
|---|---|---|
| Permitted premium family exists and fits the brief | Prefer it over the baseline and record the licence scope | Purchased craft value is ignored or used outside its rights |
| Premium files are absent or rights are unclear | Use the named OFL baseline pairing | Unlicensed binaries are embedded or work stalls unnecessarily |
| Script coverage or readability conflicts with the desired voice | Choose coverage and legibility first, then restore contrast through display treatment | Distinctive type excludes readers or breaks localisation |
| No valid display/body pair can be verified | Stop before producing the artefact and request a decision | A banned or bare-system fallback silently becomes the design |
Capability Contract
Read access to the brief, doctrine, font taxonomy, and licence information is required. Filesystem
search is required for premium-font discovery. Network access is optional for source verification;
embedding or file mutation belongs to font-embedding-and-licensing.
Degraded Mode
If premium files or licence evidence cannot be inspected, propose an OFL baseline pair and label premium use unavailable. If script specimens cannot be rendered, provide a provisional choice and block embedding until glyph coverage and metrics are checked.
The Anti-Slop Checklist
- Typeface(s) named explicitly with a one-line contextual reason - stated before output.
- None on the banned list (
ai-slop-banned-fonts.md), including secondary escape fonts. - A deliberate display+body pairing, not one font for everything.
- Licence permits the intended use, including embedding (
licensing-and-embedding.md). - Loaded/embedded correctly for the format, subsetting on for DOCX/PPTX (
embedding-by-format.md). - A sensible fallback set after, never instead of, the chosen font.
If the checklist cannot be satisfied, say so and ask. Never silently fall back to Inter or a bare system stack.
Anti-Patterns
- Picking a font "to start" and never stating it.
- Reaching for Space Grotesk/Poppins/Montserrat as the safe distinctive choice.
- Treating
08-body-ui-workhorsesas a complete identity instead of the body layer. - Using
07-script-cursive-handwrittenfor paragraphs, forms, tables, dashboards, or UI labels. - One typeface for headings, body, labels, and buttons.
- Timid mid-weights and near-identical sizes.
Outputs
| Artefact | Consumer | Evidence and acceptance condition |
|---|---|---|
| Typeface decision and pairing rationale | Artefact-producing workflow | Display/body roles, categories, context, script coverage, and licence basis are explicit |
| Type scale and embedding handoff | font-embedding-and-licensing |
Anti-slop checklist passes and unresolved licence or rendering checks are named |
- A stated typographic decision: display + body + category + reason.
- A completed anti-slop checklist.
- The type scale and a clean handoff to embedding.
Examples
examples/applied-type-scale.md- a real px/rem type scale for a named brief: the stated pairing + reason, the full scale, the fluidclamp()version, variable-font axis settings, and the anti-slop checklist run end to end.
References
doctrine/design-doctrine.md, and the references it indexes:ai-slop-banned-fonts.md,font-groups-and-usage.md,pairing-principles.md,type-scale-and-spacing.md.fonts/README.md- required eight-category folder taxonomy and new-device setup command.references/pairing-catalog.md- named, context-sorted display+body pairings.references/type-scale-recipes.md- concrete px/rem scales, fluidclamp(), variable-font axes.