Get the Newsletter

Aurelia Release Notes - June 2019

Posted by Rob Eisenberg on June 3, 2019

Today, we're pleased to share with you the 1.0 release of the Aurelia CLI!

Many of you have been using, testing, and helping to expand and improve the Aurelia CLI since we first introduced it in its earliest alpha, almost four years ago. It's been a long and winding road, but thanks to the community and core team, we're very happy with where we've landed.

If you haven't used the Aurelia CLI before, it's the best way to get up and running with a new Aurelia project. To install the CLI, from your command prompt, simply run npm install aurelia-cli -g. With the CLI installed, you can create a new project by running au new. The CLI will then ask you a few questions, create your project, and install its dependencies. Once completed, you can execute au run to immediately start your new app.

Thanks to the contributions of our community, the CLI supports all the most popular bundlers, testing tools, CSS frameworks, and more. As a result, you don't have to deal with the hassle of figuring out how to get your preferred set of tools working together; the CLI already has that worked out. Here's what we support out of the box:

  • Bundlers and Loaders - Webpack (HTTP/1.1 and HTTP/2 optimizations), Require.js, System.js
  • Transpilers - Babel, TypeScript
  • CSS Pre/Post Processors - Less, Sass, Stylus, PostCSS
  • Unit Testing - Karma+Jasmine, Jest
  • Integration Testing - Protractor, Cypress
  • Package Managers - NPM, Yarn
  • And more... - .NET project support, HTML minification, VS Code setup, etc.

If all these options seem overwhelming, never fear! When you run the CLI, you can also select a default Babel or TypeScript configuration. Also, if you've got a specific combination that you always use, the CLI now supports an "unattended" mode, which allows you to specify all your choices on the command prompt, without having to go through the wizard. The CLI will even teach you how to do this after you create your first project :)

In addition to project creation, the CLI allows you to run your app in "watch" mode, refreshing the browser as you make changes, and build for production, automatically handling environment-specific configuration and code injection. To further enhance the development experience, the CLI also ships with a default set of generators to assist you in quickly creating custom elements, custom attributes, and more. Naturally, you can create your own generators, as well as extend the CLI with your own commands.

We hope you enjoy using the Aurelia CLI as much as we did building it. As always, we're not stopping here. We'll be bringing the CLI tech forward, continuing to enhance it for Aurelia vNext as well.

Other Releases

We've had a number of other releases in addition to the Aurelia CLI. All the nitty gritty details can be found below. Of particular interest is:

  • Aurelia UX - We've added a new Slider control!
  • Aurelia Dialog - This is the planned, final 2.x beta, which stabilizes the API.
  • Aurelia Web Components - We've done more standardization work and bug fixes, enabling you to use your Aurelia custom elements as W3C Standard Web Components.

Major Releases

Major updates may include breaking changes, new features, fixes to bugs, and performance improvements.

aurelia-cli 1.0.0

Bug Fixes

  • bundler: avoid appending alias after comment (sourceMap line). ( 621bda7 )
  • bundler: fix missing json watch ( 2f5f0cd )
  • bundler: fix sourceMap source file path and sourceRoot ( d8a04c0 )
  • CLI-Bundler, Aliases: improve alias support ( 19ea1ec ), closes #1093
  • release-check: avoid duplicated e2e processes ( 615096a )
  • skeleton: allows TS plugin skeleton to support import {...} from "resources" ( eeb59c8 )
  • skeleton: fix missing .gitignore file in aurelia-cli npm package ( d13c437 ), closes #1102
  • skeleton: fix Promise polyfill on IE ( bc377dc ), closes #1079
  • skeleton: fix ts-loader option for webpack+karma setup ( beca7f3 )
  • skeleton: TS plugin skeleton to generate d.ts files ( 22075c1 )
  • skeleton: upgrade karma to v4 to get rid of deprecated circular-json ( 6501a57 )
  • webpack: fix TypeScript error on unneeded test code when running webpack ( 36d384e )
  • webpack: use typeRoots to avoid TS typing issue when cssnano and protractor are selected ( d85ca5c ), closes #1090

Minor Releases

Minor updates include new features, updates to bugs, and performance improvements.

aurelia-dialog 2.0.0-rc.6

Bug Fixes

  • build: adjust umd build, add umd-es2015 ( 342c023 )
  • package.json: fix package.json ( 5ae0d3a )


  • dialog-renderer: add native dialog renderer close #338 ( 9da52fe )
  • keyboard: allow to configure keyevent type ( 2f57949 )

aurelia-templating-resources 1.11.0

Bug Fixes

  • typings: explicit return typings for createFullOverrideContext ( abe97d3 )

aurelia-history-browser 1.4.0

Bug Fixes

  • browser-history: decode fragment, add tests ( 957532d )

Aurelia UX 0.16


  • New Slider Component!

aurelia-web-components 1.0.0-beta.3

Bug Fixes

  • Delay creation of child elements to follow w3c guidelines
  • Build, packaging, and source map improvements.

Patch Releases

Patch updates include only fixes to bugs and performance improvements.

aurelia-store 1.3.5

Bug Fixes

  • Add additional type-safety for the optional settings parameter of the localStorageMiddleware.