TeachKit project

TeachKit / Design system

Documentation v0.1 · Released product

Design system contents

Foundations

Typography and readable hierarchy

Use the actual Elza-based interface hierarchy, with practical limits for long course titles and lesson content.

On this page

Font contract

The app layout loads Adobe Typekit qff4wee.css and the body requests elza, sans-serif. The CSS also declares Geist-related theme variables, but they do not replace the body font. Local Font Awesome faces are icon fonts, not body text. Captures load the app’s configured font stylesheet; do not silently substitute an invented typography system.

Observed hierarchy

Observed hierarchy
ContextSource conventionUsage
PageHeadingtext-3xl font-extraboldOne route-level heading.
Course and lesson titlesProminent bold/black text within their compositionsLet long titles wrap in the actual responsive layout.
Section labelsUppercase text-lg font-black with divider rulesAction checklist, links and downloads.
Learner bodytext-lg and relaxed leadingReadable description and instructions.
Field labels and hintsStrong labels, muted subordinate textKeep a persistent name outside placeholder text.
NavigationCompact medium/bold textUse names that identify a destination.

Content constraints

  • Course titles should name the outcome; lesson titles should explain the next concrete topic.
  • Use real titles and descriptions for captures instead of replacing course content with generic copy.
  • Avoid a fixed height that hides multiline text in a new card variant.
  • Verify font loading, 200% zoom, and the longest available course title before approval.

Examples from the app

Actual TeachKit UI with Thomas McGee’s course content. Session, progress and connection specimens are simulated; no student data or live changes. Captured at 2× resolution or higher. Select an image to inspect it full size.

Library · Screen · Light · Desktop · 2880 × 2000 px
Fields · Component detail · Light · Desktop · 1920 × 866 px
Fields · Component detail · Light · Desktop · Focus · 1920 × 922 px

Source audit: 2026-10-07 · Revision d8cf23d0a329 · Documentation v0.1