TeachKit project

TeachKit / Design system

Documentation v0.1 · Released product

Design system contents

Overview

TeachKit design system

A practical reference for a course product that connects creator publishing, focused lessons, and action-based learning.

On this page

Product and audience

TeachKit serves two connected audiences: creators preparing courses and learners applying what they see. Its common visual language must work in discovery, a lesson player, a rich editor, and settings without hiding the purpose of each screen.

This reference documents the current local application. It adds usage guidance and identifies implementation gaps; it does not claim that an independently packaged component library or a formal design-system organization previously existed.

Evidence and boundaries

Evidence and boundaries
AreaBaseline
Sourced8cf23d0a329b822a8aa4e16831adc1683f78283
ThemeImplemented light palette; dark variables are commented out
ContentActual Thomas McGee courses retrieved through owner-scoped SELECT queries
CapturesReal learner components and real creator pages in a temporary copy
Simulated statesSession, sample progress, subscription access and connection examples
ExcludedStudent records, private emails, live saves, uploads, enrollment, payments and sending
HandoffSource references, contracts, usage rules, applied evidence and readiness register

Design principles inferred from source

  • Move from watching to doing: place concrete actions beside the lesson context.
  • Keep creators focused: separate course identity, lessons, instructions, registration and integrations into recognizable sections.
  • Reuse course identity: carry title, cover and instructor across discovery, enrollment and learning.
  • Explain progress: distinguish an action check from completing an entire lesson.
  • Keep availability explicit: published, draft and closed courses have different implications.

How to use this reference

Start with foundations before creating a new view. Choose an existing component family, match its props, and compose it within the appropriate creator or learner shell. Patterns explain the full task and its persistence boundary. Applied screens show what the implementation actually renders.

Read known gaps before shipping. A visually complete control, a Headless UI dependency, or a successful screenshot does not establish complete accessibility, authorization, payment reliability or saving behavior.

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.

Learner · Screen · Light · Desktop · 2880 × 2000 px
Learner · Screen · Light · Desktop · Full Page · 2880 × 2614 px
Creator Basic Info · Screen · Light · Desktop · 2880 × 2000 px
Creator Basic Info · Screen · Light · Desktop · Full Page · 2880 × 2120 px

Reference downloads

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