Design system contents

Foundations

Inter and readable hierarchy

The redesigned app and marketing site share a locally hosted variable font, with different scales for tasks and storytelling.

On this page

Native font contract

Both repositories declare the local Inter variable TTF with weights 100–900. The app body uses Inter, ui-sans-serif, system-ui, sans-serif at 16px with 1.6 line height. Marketing uses Inter, Arial, sans-serif. Existing Geist-related variables do not override these body declarations. Font Awesome faces are for glyph icons, not prose.

Observed hierarchy

Observed hierarchy
ContextImplementationGuidance
Workspace heading28–36px clamp; 1.25 line heightName the current task or collection.
Builder title26–34px clamp, 700 weight, −.03em trackingPreserve the course identity above the editor.
Lesson heading24px/600 in editor; 26–34px/650 in playerAllow wrapping without fixed-height truncation.
Eyebrow12px/700, uppercase, .1em trackingShort contextual label, never the only page title.
Supporting copy14–15px in controls; 18px/1.75 in course introductionKeep instructions close to the action they explain.
Marketing herotext-5xl → text-7xl, 900 weight, 1.05 line heightUse the source responsive heading rather than app typography.

Content and font checks

  • Await the actual local font before screenshots; do not silently accept a fallback.
  • Use complete, concrete course and lesson names. Check long titles at phone widths.
  • Keep numerals readable in duration, analytics, and code inputs; email-code digits use tabular numerals.
  • Specimen padding belongs to documentation framing and does not change the product type scale.

Source references

Source references
FileResponsibility
src/app/globals.cssApp typography
marketing/src/app/globals.cssMarketing font face
marketing/src/components/HomeHero.tsxMarketing heading scale

Interface examples

Native TeachKit interfaces with fictional course, account, and learner records. Service responses and media are isolated demonstrations; no customer data or live changes. Captured at 2× resolution or higher. Select an image to inspect it full size.

Lesson Editor · Component detail · Light · Desktop · Conflict · 2718 × 1764 px
Marketing Home · Featured section · Light · Desktop · 2000 × 951 px
Fields · Component detail · Light · Desktop · 2280 × 1254 px
Lesson Editor · Component detail · Light · Desktop · Video · 2718 × 1710 px
Lesson Editor · Component detail · Light · Desktop · Actions · 2718 × 1560 px
Lesson Editor · Component detail · Light · Desktop · Links · 2718 × 1449 px
Lesson Editor · Component detail · Light · Desktop · Downloads · 2718 × 1449 px
Lesson Editor · Component detail · Light · Desktop · Description · 2718 × 1479 px
Fields · Component detail · Light · Desktop · Focus · 2316 × 1290 px

Source audit: 2026-10-22 · Revision 903bbf05ca9d · Documentation v2.0.0