Skip to content

Commit

Permalink
docs: upgrade Angular guide
Browse files Browse the repository at this point in the history
I've removed any mentions of Angular versions older than 15 since they haven't been maintained for several years. Angular 15 LTS support will end in May 2024.

I've also eliminated the manual installation guide targeting Angular 6 and older versions from the documentation. It shouldn't be included.

Additionally, I've added a warning about the importance of updating the builder before running schematics.
  • Loading branch information
arturovt committed Sep 10, 2024
1 parent d8cbffa commit f6a0e33
Showing 1 changed file with 15 additions and 1 deletion.
16 changes: 15 additions & 1 deletion versioned_docs/version-6.x/ecosystem-angular.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ For instructions on how to test this locally before creating a pull request, see

## Angular versions

### Angular 1 (AngularJS)
### AngularJS

AngularJS is supported by [single-spa-angularjs](https://github.com/single-spa/single-spa-angularjs), instead of single-spa-angular.
See [AngularJS docs](/docs/ecosystem-angularjs).
Expand Down Expand Up @@ -155,6 +155,16 @@ Angular 15 is supported by single-spa-angular@8.
Both the [single-spa-angular schematics](#schematics) and the [single-spa helpers](#the-single-spa-helpers)
work with Angular 15. Follow the [Angular CLI instructions](#angular-cli).

Angular 16 is supported by single-spa-angular@9.

Both the [single-spa-angular schematics](#schematics) and the [single-spa helpers](#the-single-spa-helpers)
work with Angular 16. Follow the [Angular CLI instructions](#angular-cli).

Angular 17 is supported by single-spa-angular@9.

Both the [single-spa-angular schematics](#schematics) and the [single-spa helpers](#the-single-spa-helpers)
work with Angular 17. Follow the [Angular CLI instructions](#angular-cli).

## Angular CLI

You may use Angular CLI and single-spa together with any version of Angular. However, the [Angular CLI schematics](#schematics)
Expand All @@ -171,6 +181,10 @@ ng new my-app --routing --prefix my-app
cd my-app
```

#### :warning: Please read this before proceeding :warning:

Starting from Angular 17, when running `ng new`, a project with the ESBuild builder is created by default (`"builder": "@angular-devkit/build-angular:application"`). However, ESBuild does not support all of the required features for single-spa, such as SystemJS output. Therefore, we cannot simply provide the ESBuild plugin in the same way we do for Webpack with config transformer. Before running schematics or performing any updates, it is necessary to change the `builder` property inside the `angular.json` to `@angular-devkit/build-angular:browser`, and the `browser` property (typically pointing to `src/main.ts`) should be changed to `main`.

In the root of your Angular CLI application run the following:

```sh
Expand Down

0 comments on commit f6a0e33

Please sign in to comment.