Skip to content

docs(angular): deprecate IonicModule#4589

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

docs(angular): deprecate IonicModule#4589
thetaPC wants to merge 2 commits into
major-9.0from
FW-6267

Conversation

@thetaPC

@thetaPC thetaPC commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Issue URL: internal

What is the current behavior?

The Angular documentation presents the Modules approach and IonicModule as a fully supported option with no indication that it is being phased out. The Build Options guide, the per config guides, and the Platform guide all show IonicModule.forRoot() examples, and the Ionic 9 upgrade guide does not mention the deprecation.

What is the new behavior?

  • docs/angular/build-options.md: notes that the Modules approach and IonicModule are deprecated as of Ionic 9, adds a Deprecation Notice admonition to the Modules section, and adds a code splitting note explaining the single entry point limitation of the standalone build.
  • docs/updating/9-0.md: adds an IonicModule Deprecation entry that points to the migration guide.
  • docs/developing/config/* and docs/angular/platform.md: add a deprecation comment above the IonicModule examples that points developers to provideIonicAngular(). The Platform guide example is converted into Angular and Angular (Standalone) tabs so the standalone equivalent is shown alongside the Modules version.

Does this introduce a breaking change?

  • Yes
  • No

Other information

Previews:

  • docs/angular/build-options
  • docs/angular/platform
  • docs/updating/9-0
  • docs/developing/config/global
  • docs/developing/config/per-component
  • docs/developing/config/per-platform
  • docs/developing/config/per-platform-fallback
  • docs/developing/config/per-platform-overrides

@vercel

vercel Bot commented Jul 16, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
ionic-docs Ready Ready Preview, Comment Jul 17, 2026 12:15am

Request Review

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant