From 69cfe7227162142b897ca1b5f78fed389964b502 Mon Sep 17 00:00:00 2001 From: Amanda Johnston <90629384+amandaejohnston@users.noreply.github.com> Date: Mon, 25 Sep 2023 15:04:49 -0500 Subject: [PATCH] docs(angular): add links to Angular's standalone migration guide --- docs/angular/build-options.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/angular/build-options.md b/docs/angular/build-options.md index ba05435cdfb..a8e314cdfec 100644 --- a/docs/angular/build-options.md +++ b/docs/angular/build-options.md @@ -32,6 +32,10 @@ See the [Standalone Migration Guide](#migrating-from-modules-to-standalone) for All Ionic imports should be imported from the `@ionic/angular/standalone` submodule. This includes imports such as components, directives, providers, and types. Importing from `@ionic/angular` may pull in lazy loaded Ionic code which can interfere with treeshaking. ::: +:::info +This section assumes your application has already been converted to use Angular's standalone architecture. For information on migrating, see [Angular's migration guide](https://angular.io/guide/standalone-migration). +::: + **Bootstrapping and Configuration** Ionic Angular needs to be configured when the Angular application calls `bootstrapApplication` using the `provideIonicAngular` function. Developers can pass any [IonicConfig](../developing/config#ionicconfig) values as an object in this function. Note that `provideIonicAngular` needs to be called even if no custom config is passed. @@ -154,6 +158,10 @@ The Standalone option is newer than the Modules option, so developers may wish t Migrating to Ionic standalone components must be done all at the same time and cannot be done gradually. The Modules and Standalone approaches use two different build systems of Ionic that cannot be used at the same time. +:::info +Migrating your Angular application to use the standalone architecture is optional when using Ionic's standalone components, but the two processes are separate. For information on migrating your application as a whole, see [Angular's migration guide](https://angular.io/guide/standalone-migration). +::: + ### Standalone-based Applications Follow these steps if your Angular application is already using the standalone architecture, and you want to use Ionic UI components as standalone components too.