knaxuslearn · build · ship

Roadmaps / TypeScript

Programming Languages · 16 study weeks · 4 phases

TypeScript Roadmap Beta

TypeScript catches mistakes before they run, but only where the types match what really happens at runtime. These 16 study weeks teach the type system as a design tool, the boundary where types meet real data, the compiler and its tooling (including the move to the native compiler in TypeScript 7) and how to keep a large codebase honest. You build one product, a typed API contract kit that keeps a server and a web client from drifting apart, and every phase adds a checkpoint to it. At 8 hours a week the core path is 128 hours and takes 16 weeks. At 12 hours a week it takes about 11 weeks, and at 16 hours a week about 8 weeks. At the end you can design types that make wrong states hard to write, prove where they stop being true, and speed up and migrate a real build. This roadmap assumes you can already write JavaScript. The JavaScript roadmap teaches the language and runtime.

This roadmap is in beta and keeps improving over time. If you spot an error, please email your suggestions and corrections to [email protected].

Read first

  1. Phase 1 · Study weeks 1-4

    The type system as a design tool

    This phase makes the first checkpoint possible: a domain model where wrong states do not compile, and a test suite that proves it.

    • 5 repos
    • Milestone checkpoint
    1. Study week 1Structural typing and excess property checks8 h
    2. Study week 2Generics, constraints and inference8 h
    3. Study week 3Conditional, mapped and template literal types8 h
    4. Study week 4Soundness holes: assertions, index access, optional against undefined8 h
  2. Phase 2 · Study weeks 5-8

    Runtime boundaries and the contract

    This phase makes the second checkpoint possible: types that match real data, because every boundary parses what it receives.

    • 5 repos
    • Milestone checkpoint
    1. Study week 5Types are erased8 h
    2. Study week 6Errors as values and typed errors8 h
    3. Study week 7One contract, three uses: handler, client, validator8 h
    4. Study week 8OpenAPI and JSON Schema output8 h
  3. Phase 3 · Study weeks 9-12

    The compiler, the build and the move to TypeScript 7

    This phase makes the third checkpoint possible: a build that is fast, correct for consumers and ready for the native compiler.

    • 4 repos
    • Milestone checkpoint
    1. Study week 9tsconfig and module resolution (nodenext and bundler)8 h
    2. Study week 10Project references and incremental builds8 h
    3. Study week 11TypeScript 6 and TypeScript 7: what changed8 h
    4. Study week 12Type performance: instantiations and depth8 h
  4. Phase 4 · Study weeks 13-16

    Large codebases, libraries and governance

    This phase makes the last checkpoint possible: types other teams can rely on, a strictness plan that ships in steps and a policy people follow.

    • 5 repos
    • Milestone checkpoint
    1. Study week 13A strictness ratchet for a large codebase8 h
    2. Study week 14Library type design: overloads against generics8 h
    3. Study week 15Codemods with ts-morph or jscodeshift8 h
    4. Study week 16A type-safety policy and review checklist8 h

Also in this roadmap