Skip to content

feat(angular): support Angular 21, drop Angular 16 and 17#31185

Open
ShaneK wants to merge 13 commits into
major-9.0from
feat/angular-21-support
Open

feat(angular): support Angular 21, drop Angular 16 and 17#31185
ShaneK wants to merge 13 commits into
major-9.0from
feat/angular-21-support

Conversation

@ShaneK
Copy link
Copy Markdown
Member

@ShaneK ShaneK commented Jun 2, 2026

Issue number: resolves #30907


What is the current behavior?

Ionic Angular only currently supports Angular 16-20

What is the new behavior?

Ionic Angular now supports Angular 18 through 21 and drops 16 and 17. The ng16/ng17 test apps are removed, an ng21 app is added, and the tsconfigs are tightened for the 18+ minimum.

autocorrect on ion-input and ion-searchbar becomes a boolean (default false), mapped internally to the native 'on'/'off' attribute. This is required by TypeScript 5.9, which is required by Angular 21. It is the primary breaking change that forced this into a major version release of Ionic Framework.

Also bundles v9 housekeeping: @stencil/core bumped to 4.43.5 and TypeScript 5.9 in the React and Vue test apps.

Does this introduce a breaking change?

  • Yes
  • No

The following changes are required for migration:

  • Apps on Angular 16 or 17 must upgrade to 18 or later.
  • Existing NgModule projects upgrading to Angular 21 must add provideZoneChangeDetection() to bootstrapModule's applicationProviders in main.ts. ng-add only patches standalone app.config.ts, not main.ts, so the NgModule path is manual (documented in the schematic's JSDoc).
  • autocorrect now takes true/false instead of 'on'/'off'. Replace autocorrect="on" with [autocorrect]="true" and autocorrect="off" (or the default) with false.

Other information

Preview:

Current dev build (2025-06-02):

8.8.9-dev.11780414486.1df2bd72

Docs PR: ionic-team/ionic-docs#4529

@ShaneK ShaneK requested a review from a team as a code owner June 2, 2026 13:25
@ShaneK ShaneK requested a review from gnbm June 2, 2026 13:25
@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 2, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ionic-framework Ready Ready Preview, Comment Jun 2, 2026 3:08pm

Request Review

@github-actions github-actions Bot added package: core @ionic/core package package: angular @ionic/angular package package: vue @ionic/vue package package: react @ionic/react package labels Jun 2, 2026
@ShaneK ShaneK changed the title feat(angular)!: support Angular 21, drop Angular 16 and 17 feat(angular): support Angular 21, drop Angular 16 and 17 Jun 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

package: angular @ionic/angular package package: core @ionic/core package package: react @ionic/react package package: vue @ionic/vue package

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant