Skip to content

feat(angular): deprecate IonicModule#31270

Draft
thetaPC wants to merge 3 commits into
major-9.0from
FW-6267
Draft

feat(angular): deprecate IonicModule#31270
thetaPC wants to merge 3 commits into
major-9.0from
FW-6267

Conversation

@thetaPC

@thetaPC thetaPC commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Issue number: resolves internal


What is the current behavior?

@ionic/angular ships a module-based (lazy) build whose entry point is IonicModule. NgModule apps register Ionic by importing IonicModule and calling IonicModule.forRoot(). Even though standalone components with provideIonicAngular() are the default and recommended path in Ionic 9, IonicModule gives no signal that it is on its way out.

What is the new behavior?

  • Deprecated IonicModule and IonicModule.forRoot() with @deprecated JSDoc that points developers to provideIonicAngular().
  • Emit a one time deprecation warning from IonicModule.forRoot() at bootstrap.
  • Documented the deprecation in BREAKING.md.
  • Added deprecation notes to the Angular package README.md and the in repo Angular testing docs.

Does this introduce a breaking change?

  • Yes
  • No

Deprecating IonicModule does not affect its functionality. Existing apps continue to work with no changes after upgrading. Full removal is planned for a future major version and is documented in BREAKING.md.

Other information

Dev build: 8.8.14-dev.11784243422.11f0110c

@vercel

vercel Bot commented Jul 15, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
ionic-framework Ready Ready Preview, Comment Jul 16, 2026 6:08pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

package: angular @ionic/angular package

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant