Skip to main content
Back to Scope Definition v2.0.0

Scope Explainer

Typography Integration — Scope Explainer

Typography integration is the engineering that loads, renders and tokenizes web fonts the client has already licensed — not the selection of typefaces, the design of custom fonts, or the procurement and negotiation of font licenses.

Commercial explainer only. In any conflict, the binding clause prevails. Read the binding clause (item #9).

Version
v2.0.0
Last updated
2026-05-16
Immutability
Immutable

What it means & why it matters

A typography layer is the loading strategy plus the type-scale tokens that every component reuses. SessDev takes the fonts the client supplies (self-hosted files with a valid license, or a hosted-service account such as Adobe Fonts or Google Fonts), wires @font-face declarations with the right format, weight and display strategy, defines a deterministic fallback stack to minimize CLS, and exposes type-scale and weight tokens that components reference. This is engineering plumbing.

What it is not: a type-design service. SessDev does not pick the typefaces, does not commission custom fonts, does not negotiate licenses with foundries, does not run multilingual type research, and does not author the brand-typography system documentation. Those are design-discipline and procurement deliverables and they belong to the client, the design team or an external foundry.

The fonts and their licenses are owned by the client. SessDev integrates assets the client has the right to use. Font selection, custom-typeface design, license procurement and hinting/kerning work are explicit exclusions.

What SessDev includes

  • Ingestion of the client-supplied font files (woff2 preferred, woff fallback) or hosted-service configuration (Adobe Fonts kit, Google Fonts URL) through a structured handoff.
  • Loading strategy chosen against measured CLS: font-display: swap or optional, preload hints on critical-path weights, deferred load for non-critical weights.
  • @font-face declarations (or next/font wiring when applicable) with correct format hints, unicode-range when subsetting is in scope, and font-feature-settings the client requires.
  • A deterministic fallback stack matched on x-height and width to minimize layout shift between fallback and webfont render.
  • A type-scale token set (display, h1–h6, body, body-sm, label, caption) wired into Tailwind config and CSS variables so components reference scale steps by intent.
  • Wiring of every weight the design uses (e.g. 400/500/700) including italic variants when supplied; weights not used by the design are not loaded.
  • Subsetting of self-hosted fonts to the locales declared in scope (latin, latin-ext, or per-locale ranges) to keep payload below the documented budget.
  • 1 validation pass: Lighthouse type-loading audit, visual QA against the supplied type spec, license verification that every loaded weight is covered.
  • Handoff document listing every loaded family/weight, its source (self-hosted or service), its license reference and the procedure to swap a typeface without touching component code.

What is excluded

  • Font selection — evaluating typefaces, matching them to brand voice, pairing display and body fonts.
  • Custom typeface design, glyph drawing, OpenType feature authorship, custom ligatures or stylistic sets.
  • License procurement — negotiating with foundries, buying webfont licenses, calculating monthly-pageview tiers, securing redistribution rights.
  • Authorship of the typography system — deciding the type scale, line-height pairings, modular ratios, or vertical-rhythm rules.
  • Brand research, competitive type audits, category-typography analysis.
  • Typography audit of the supplied selection, legibility testing, reading-comprehension studies.
  • Multilingual type research — verifying glyph coverage for non-Latin scripts, sourcing complementary fonts for CJK or RTL, language-pair quality reviews.
  • Hinting, kerning passes, custom OpenType-feature tuning or any font-file editing.
  • Display-type design, custom hero typography, lettering or hand-set headlines.
  • Icon-font creation. Wiring of an existing icon font is in scope via the icon-library integration item; authoring one is not.
  • Authorship of the brand-typography system documentation — usage rules, do/don't grids, brand-guidelines sections on type.

Risks if this is mis-configured

  • Unlicensed fonts shipped to production

    Self-hosting a font file without a valid webfont license exposes the client to foundry enforcement and takedown notices. SessDev validates that every loaded weight has a license reference in the handoff; if a file arrives without one, it is rejected. License procurement remains with the client.

  • Cumulative Layout Shift from font swap

    A naive font-display: swap without a matched fallback stack flips text width and height when the webfont arrives, tanking CLS and Core Web Vitals. The fallback-stack work in scope tunes ascent-override and size-adjust to minimize the jump; without that pass, the page ships with a measurable CWV regression.

  • Fallback-stack mismatch in non-supported locales

    A fallback stack tuned for Latin can break catastrophically on a locale whose primary script is not covered by the webfont. The multilingual-type-research exclusion is intentional; if locales beyond the declared set are added later, the fallback stack must be revisited under the Care retainer.

  • Missing glyphs at runtime

    A licensed font that does not cover a required glyph (long dash, smart quote, accented character, Greek letter in a marketing headline) silently falls back to system, producing visible inconsistency. Glyph-coverage validation is a design-team responsibility; SessDev integrates what the client validates.

  • Weight sprawl bloats the payload

    Loading every available weight “just in case” inflates the font payload by hundreds of kilobytes per locale. The scope only loads weights the design actually uses; ongoing discipline as new components ship is what the Care retainer enforces.

  • Performance regression after a font swap

    Swapping to a heavier family or adding a new weight without re-running the loading-strategy audit can re-introduce CLS, FCP and LCP regressions. The handoff procedure documents the audit step; skipping it is the most common drift cause after launch.

  • FOIT / FOUT drift across browsers

    Different browsers honor font-display strategies inconsistently; what looked correct on Chromium can render as a flash of invisible text on Safari for a percentage of users. Validation in scope catches the baseline; ongoing browser-version regressions are absorbed by the Care retainer.

Use case — Partner

Your agency or in-house design team owns typography selection, pairing and brand-system authorship; your procurement function (or the design team) owns license negotiation. SessDev integrates the result. Recommended pairing: SessDev Care retainer to absorb webfont-format upgrades, browser-engine regressions and multi-locale glyph coverage as the product grows.

Apply as a partner

Use case — One-Shot

You receive the typography layer as part of the buyout. After handoff the source code is yours, and so is the responsibility for keeping fonts licensed, loading strategies tuned and fallback stacks aligned with new locales. If you do not have an in-house engineering owner for this, add a Shield + Care plan at quote time — webfont licensing and CWV drift are the most common silent failures here.

Request a one-shot quote

Related scope items

Frequently asked questions

Can SessDev select our fonts?
No. Font selection is a design-discipline deliverable and is explicitly out of scope. SessDev integrates the typefaces your design team or external studio chooses.
Do you handle font licensing?
No. License procurement, foundry negotiation, monthly-pageview tier calculation and any redistribution agreements remain with the client. SessDev validates that every loaded weight has a license reference at integration time, but does not buy or negotiate licenses.
Can you design a custom typeface for us?
No. Custom typeface design, glyph drawing and OpenType-feature authorship are foundry-grade deliverables and are out of scope. SessDev integrates what a foundry or your design team delivers.
Do you support variable fonts?
Yes, when the client supplies a variable-font file with a valid license. The wiring uses font-variation-settings tokens; selection of which axes to use is a design-team decision.
Will the typography layer pass Core Web Vitals?
The loading-strategy work in scope is tuned for CLS and LCP against the supplied family list. CWV outcomes also depend on factors outside typography (image weight, third-party scripts). The Care retainer absorbs CWV drift across browser-engine changes after launch.

Legal reference

Read the binding scope clause — item #9, v2.0.0