TL;DR

Analog now supports Angular v22, offering performance improvements and new features. Upgrading is recommended to take advantage of these enhancements.

New

• Angular 22 Support: Full compatibility with the latest Angular release.
• Project Creation: The create-analog tool now includes options for skipping Vite overrides and using Angular v22 RC templates.

Fixes Worth Knowing

• Improved diagnostics and template compilation for Angular applications, resolving issues with signal detection and model metadata.
• Fixed issues with .ts file imports and build processes in library mode.

Before You Upgrade

• Ensure your project dependencies are compatible with Angular v22 and Nx 22.7.5.
• Review your custom Vite configurations, as the new templates may override existing settings.

TL;DR

Analog now supports Angular 22 and Nx 22.7.5, enabling developers to leverage the latest features and improvements in these frameworks.

New

• create-analog: A new flag --skipViteOverrides is available, and Angular v22 RC templates have been added.
• Angular 22 Support: Upgraded to Angular 22 RC, providing access to its new APIs and performance enhancements.

Fixes Worth Knowing

• Vite Plugin: Improved diagnostics (error reporting) for Angular applications, especially when using libraries or advanced compilation options.
• TypeScript Imports: Fixed an issue where Vite incorrectly handled .ts file imports, preventing build errors.

Before You Upgrade

If you are using a custom Vite configuration, test thoroughly after upgrading to ensure compatibility with the latest Angular and Vite versions.

TL;DR

Analog has been migrated to Nitro v3 (a server framework) and Vite, significantly changing the platform's underlying architecture and requiring updates to your vite.config.ts.

Breaking

• Platform Migration: The @analogjs/vite-plugin-nitro dependency is replaced by nitro/vite. Users previously using @analogjs/vite-plugin-nitro directly must now install nitro and add nitro() to their Vite plugin chain alongside analog() and @analogjs/vite-plugin-angular.

New

• Page Load Queries: A definePageLoadQueries helper has been added, enabling more control over data fetching within pages using tanstack-query (a data fetching library). This allows you to prefetch data efficiently.
• Platform Architecture: Analog now bundles Nitro v3's first-party nitro/vite plugin, improving performance and integration with the wider Vite ecosystem.

Fixes Worth Knowing

• Storybook Support: Improved compatibility with Storybook 10.4 and later.
• Angular Compatibility: Fixed issues with @Service decorator support and TypeScript compilation in the fast compiler.
• Data Hydration: Improved data hydration during server-side rendering for better initial load performance.

Before You Upgrade

• Update your vite.config.ts to include nitro() in your plugin chain as described in the breaking changes section.
• Install nitro as a dev dependency: npm install -D nitro.

TL;DR

Analog now fully supports Nx 22.x, improving compatibility for users of that build system (build tool).

Fixes Worth Knowing

• Angular Users: TestBed.overrideXXX() APIs now function correctly in Ahead-of-Time (AOT) compilation mode.
• Angular Package Optimization: Vite plugin optimizations for Angular packages have been expanded.
• Storybook Users: Compatibility with Storybook Angular 1.x has been adjusted.

TL;DR

Angular v20.3.x is now supported, enabling users to upgrade their projects to the latest Angular version while continuing to leverage Analog’s capabilities.

New

• Angular Support: Added support for Angular v20.3.x (JavaScript framework).
• Environment Config: vite-plugin-angular now supports file replacements per environment, allowing for more flexible configuration of assets.

Fixes Worth Knowing

• Angular Resolution: Improved how vite-plugin-angular resolves modules, ensuring it uses configured conditions before falling back to defaults.
• Plugin API: Added inlineStylesExtension to the plugin API, providing more control over style handling (styling options).