Upgraded to Angular 21, now have Tour v16 and nothing compiles

[Keorl]

Hi,
I had to upgrade Tour to v16 when I upgraded Angular (and Material) from v17 to v21.
Now nothing compiles, because you removed the Module.
I took a look at the doc, I can't find anything guide about migrating, any version notes, any explanation about the fact that everything changed in a non-backward-compatible way (and why). Am I looking at the wrong place ?
The documentation shows that using v16 is substantially more complicated than using v15 (see respective Setup pages).

I apparently need to add declarations in app.config.ts : I don't have such a config file
I apparently need to import TourMatMenu in my standalone components : none of my components is standalone
I apparently need to have provideRouter() : I'm not using provideRouter. I have a RouterModule (that imports TourMatMenuModule)

Is there any way to migrate properly ? I'm lost here.

[hakimio]

Read the release notes. Specifically the "Breaking Changes" section.

The documentation shows that using v16 is substantially more complicated than using v15

No, it's not much more complicated and major version releases are not guaranteed to be backwards compatible. The documentation is just a bit more comprehensive.

Ok, here is what you have to do when using NgModule based application (I'll try to update the docs some time soon to add NgModule section).

1. Add provideUiTour() to your AppModule:

@NgModule({
    // ....
    providers: [provideUiTour()]
})
export class AppModule {}

2. Import TourMatMenu in your NgModule:

@NgModule({
    // ....
    // yes, you have to use spread syntax - otherwise you'll get a TS type error. Not my fault, but Angular bug.
    imports: [...TourMatMenu],
    providers: [provideUiTour()]
})
export class AppModule {}

3. It doesn't matter if you use provideRouter() or RouterModule.

Everything else is pretty much the same like in v15.

[hakimio]

Documentation has been updated with NgModule examples.

[Keorl]

Thanks a lot !!

And I did miss the release notes, thanks for the link !