🚨 Breaking Changes
Aurelia 2 Beta 24 introduces important breaking changes, but as always, we’ve got you covered with the details below.
Vite Plugin: Vite v6 Support
- The Vite plugin now requires Vite v6. Update your project dependencies accordingly.
Commit
Templating: Controller Host Removal
- We’ve changed how Aurelia handles custom element hosts: if a host is already tied to another custom element, Aurelia won’t create a new one. This mostly helps you avoid surprises/magic behaviors. Commit
Type-Checking: Non-Public Members
- Type-checking now supports non-public members, improving tooling and developer experience.
Commit
Documentation: New Tutorials & Guides
- Tutorials for integrating Svelte, building with AI, creating a weather app, using web workers, websockets, and advanced list rendering and lambda expressions are now available.
Commit
✨ New Features
Multiple .class
Values in Templates
- The template compiler now supports multiple
.class
values, making it easier to manage dynamic classes. The docs have also been updated to reflect this new behavior. Commit
Router-Lite: Navigation Strategy
- New navigation strategy support in
router-lite
enables more flexible routing scenarios.
Commit
DOM: Toggle $au and $aurelia
- You can now toggle the
$au
and$aurelia
properties on DOM elements. This feature is designed to allow applications to make it harder to poke into or reverse engineer the view model/component trees of an Aurelia application. Some apps may wish to hide these properties completely for security or privacy reasons.
Commit
Type-Checking: Non-Public Members
- Type-checking now supports non-public members, improving tooling and developer experience.
Commit
Documentation: New Tutorials & Guides
- Tutorials for integrating Svelte, building with AI, creating a weather app, using web workers, websockets, and advanced list rendering and lambda expressions are now available.
Commit
🐞 Bug Fixes
Aurelia 2 Beta 24 includes a host of bug fixes for improved stability and reliability:
- i18n: Reactive translation of conditional projected content (
t-params
).
Commit - Dialog Service: Updated tests for new error messages.
Commit - Validation: Released references to binding behavior sources, invalidated property info cache, and improved rule discovery for nested expressions.
Commits , a0b9ae6 , f1e8956 - Observation: Allowed property deletion with proxies.
Commit - Ref Binding: Updates value when key expression changes.
Commit - Router-Lite: Cancelling navigation with redirection from
canLoad
hook in child routes.
Commit - Tooling/Typechecking: Improved method call support.
Commit
📚 Documentation Updates
Expanded documentation with new tutorials and guides for Svelte, ChatGPT, weather apps, web workers, websockets, list rendering, and lambda expressions.
CommitAdded in more detailed error documentation to help you understand and fix errors in your code. Commit
🔗 Full Changelog
For a complete list of changes in Beta 24, visit the full changelog .
📥 Upgrade Guide
To upgrade to Aurelia 2 Beta 24:
- Update your project dependencies to the latest Aurelia packages and Vite v6.
- Review breaking changes and update your code as needed.
- Test your application thoroughly to ensure compatibility.
If you have any questions or need assistance, please join us on Discord and reach out to the team.
Aurelia 2 Beta 24 continues to push the framework forward with powerful new features, improved stability, and expanded documentation.