Angular Upgrade Planner
Pick a source and target Angular version (8–22) for an ordered, checkable upgrade plan — ng update commands, breaking changes, deprecations, and migrations.
Choose your upgrade path
Angular 15 → Angular 16
(6 steps)Commit or stash all work, then make sure you are on the latest minor/patch of your current major before running ng update. Upgrade exactly one major at a time and run the app/tests after each hop.
Angular 16 requires Node.js 16.14+ or 18.10+ and TypeScript 4.9.3 up to 5.1.
Check your Node.js & TypeScript versions for Angular 16 →Update the core framework and CLI together. This applies the official automatic migration schematics for this version.
ng update @angular/core@16 @angular/cli@16
Non-destructive hydration is available in developer preview with provideClientHydration (SSR still uses @nguniversal in v16). An esbuild-based build and dev server is also in developer preview.
The Angular Compatibility Compiler (ngcc) is removed, so any dependency still shipped in View Engine format fails to build. Update or replace those libraries before this hop.
Angular Signals arrive in developer preview, along with takeUntilDestroyed/DestroyRef, required inputs, and binding Router data/params/title to component inputs via withComponentInputBinding. Self-closing tags are supported.
Sources: Angular Update Guide: v15 → v16 · Angular 16.0.0 release notes
Tip: Upgrade one major at a time and run ng update for each hop — it applies the official migration schematics automatically. Commit between hops and run your tests. This is a representative checklist of the major changes; always confirm specifics against the official Angular Update Guide for your exact versions.
Upgrading Angular 15 to Angular 16
This plan covers the full path from Angular 15 to Angular 16 — 1 version hop and 6 steps in total. Upgrade one major at a time, running ng update for each hop so the official migration schematics apply. Commit and run your tests between hops.
Breaking changes to check between Angular 15 and Angular 16
- ngcc is removed — View Engine libraries no longer work (Angular 15 → Angular 16): The Angular Compatibility Compiler (ngcc) is removed, so any dependency still shipped in View Engine format fails to build. Update or replace those libraries before this hop.
Hops in this path
- Angular 15 → Angular 16 — 6 steps
Before you start
- Commit or stash your work and upgrade on a branch so you can roll back.
- Get on the latest minor/patch of Angular 15 before the first hop.
- Update third-party libraries (including Angular Material/CDK) alongside each hop, and run your tests after each one.
Sources
Every step in this plan is checked against Angular's official documentation and release notes. Last reviewed .