Aurelia 2

This is the Aurelia 2 monorepo, containing core and plugin packages, examples, benchmarks, and documentation for the upcoming major version of everybody's favorite modern JavaScript framework, Aurelia.

Introduction

Aurelia is a modern, front-end JavaScript framework for building browser, mobile, and desktop applications. It focuses on aligning closely with web platform specifications, using convention over configuration, and having minimal framework intrusion. Basically, we want you to just write your code without the framework getting in your way. :wink:

Aurelia applications are built by composing a series of simple components. By convention, components are made up of a vanilla JavaScript or Typescript class, with a corresponding HTML template.

//app.js
export class App {
  welcome = "Welcome to Aurelia";

  quests = [
    "To seek the holy grail",
    "To take the ring to Mordor",
    "To rescue princess Leia"
  ];
}

<!-- app.html -->
<form>
  <label>
    <span>What is your name?</span>
    <input value.bind="name & debounce:500">
  </label>

  <label>
    <span>What is your quest?</span>
    <select value.bind="quest">
      <option></option>
      <option repeat.for="q of quests">${q}</option>
    </select>
  </label>
</form>

<p if.bind="name">${welcome}, ${name}!</p>
<p if.bind="quest">Now set forth ${quest.toLowerCase()}!</p>

This example shows you some of the powerful features of the aurelia binding syntax. To learn further, please see our documentation.

Feeling excited? Check out how to use makes to get started in the next section.

Note: Please keep in mind that Aurelia 2 is still in beta. A number of features and use cases around the public API are still untested and there will be a few more breaking changes.

Getting Started

First, ensure that you have Node.js v8.9.0 or above installed on your system. Next, using npx, a tool distributed as part of Node.js, we'll create a new Aurelia 2 app. At a command prompt, run the following command:

npx makes aurelia

This will cause npx to download the makes scaffolding tool, along with the aurelia generator, which it will use to guide you through the setup process. Once complete, you'll have a new Aurelia 2 project ready to run. For more information on Aurelia's use of makes, see here. If you aren't interested in taking our preferred approach to generating a project, you can also see the examples folder in this repo for pure JIT setups (no conventions) with various loaders and bundlers.

Documentation

You can read the documentation on Aurelia 2 here. Our new docs are currently a work-in-progress, so the most complete documentation is available in our getting started section. If you've never used Aurelia before, you'll want to begin with our Quick Start Guide.

Contributing

If you are interested in contributing to Aurelia, please see our contributor documentation for more information. You'll learn how to build the code and run tests, how best to engage in our social channels, how to submit PRs, and even how to contribute to our documentation. We welcome you and thank you in advance for joining with us in this endeavor.

Staying Up-to-Date

To keep up to date on Aurelia, please visit and subscribe to the official blog and our email list. We also invite you to follow us on twitter. If you have questions, have a look around our Discourse forum. For chat on Aurelia 2, join our new Aurelia 2 community on Discord. If you'd like to join the growing list of Aurelia sponsors, please back us on Open Collective.

License

Aurelia is MIT licensed. You can find out more and read the license document here.

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

2.0.0-beta.25 (2025-07-10)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.24 (2025-04-27)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.23 (2025-01-26)

Features:

• tooling: type-checking for templates - Phase1 (#2066) (ebc1d0c)

2.0.0-beta.22 (2024-09-30)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.21 (2024-08-08)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.20 (2024-07-07)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.19 (2024-06-12)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.18 (2024-05-23)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.17 (2024-05-11)

Refactorings:

• kernel: mark side effect free (#1964) (22c8f71)

2.0.0-beta.16 (2024-05-03)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.15 (2024-04-17)

Refactorings:

• *: migration to TC39 decorators + metadata simplification (#1932) (22f90ad)

2.0.0-beta.14 (2024-04-03)

Features:

• i18n: support multiple versions of i18next (#1927) (0789ee5)

2.0.0-beta.13 (2024-03-15)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.12 (2024-03-02)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.11 (2024-02-13)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.10 (2024-01-26)

Refactorings:

• enums: string literal types in favour of const enums (#1870) (e21e0c9)

2.0.0-beta.9 (2023-12-12)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.8 (2023-07-24)

Refactorings:

• ref: deprecate view-model.ref and introduce component.ref (#1803) (97e8dad)

2.0.0-beta.7 (2023-06-16)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.6 (2023-05-21)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.5 (2023-04-27)

Note: Version bump only for package @aurelia/http-server

2.0.0-beta.4 (2023-04-13)

Features:

• vite-plugin: add plugin for vite (#1726) (564e533)

Bug Fixes:

• ci: fix vite build in ci, upgrade chromedriver (564e533)

Refactorings:

• all: upgrade rollup config files (564e533)

2.0.0-beta.3 (2023-03-24)

Refactorings:

• build: use turbo to boost build speed (#1692) (d99b136)

2.0.0-beta.2 (2023-02-26)

Features:

• *: add vite plugin (#1651) (5f3a88d)

2.0.0-beta.1 (2023-01-12)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.41 (2022-09-22)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.40 (2022-09-07)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.39 (2022-09-01)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.38 (2022-08-17)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.37 (2022-08-03)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.36 (2022-07-25)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.35 (2022-06-08)

Features:

• ts-jest,babel-jest: upgrade to jest v28 (#1449) (b1ec85c)

2.0.0-alpha.34 (2022-06-03)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.33 (2022-05-26)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.32 (2022-05-22)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.31 (2022-05-15)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.30 (2022-05-07)

Refactorings:

• runtime-html: remove .js from im/export, add type to barrel (973ae46)
• runtime: remove .js from im/export, add type to barrel (973ae46)
• kernel: remove .js from im/ex, add type to barrel (973ae46)
• testing: remove .js from im/ex, add type to barrel (973ae46)
• store-v1: remove .js from im/ex, add type to barrel (973ae46)
• validation: remove .js from im/ex, add type to barrel (973ae46)
• validation-html: remove .js from im/ex, add type to barrel (973ae46)
• validation-i18n: remove .js from im/ex, add type to barrel (973ae46)
• router-lite: remove .js from im/ex, add type to barrel (973ae46)
• router: remove .js from im/ex, add type to barrel (973ae46)
• i18n: remove .js from im/ex, add type to barrel (973ae46)
• fetch-client: remove .js from im/ex, add type to barrel (973ae46)
• tests: correct import origins (973ae46)
• all: remove imports from re-barrel (973ae46)
• all: remove imports of re-barrel (973ae46)
• all: remove imports of re-barrel (973ae46)
• all: remove imports of re-barrel (973ae46)

2.0.0-alpha.29 (2022-04-27)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.28 (2022-04-16)

Refactorings:

• router: restore aurelia packages (334864d)

2.0.0-alpha.27 (2022-04-08)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.26 (2022-03-13)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.25 (2022-03-08)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.24 (2022-01-18)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.23 (2021-11-22)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.22 (2021-10-24)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.21 (2021-09-12)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.20 (2021-09-04)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.19 (2021-08-29)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.18 (2021-08-22)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.17 (2021-08-16)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.16 (2021-08-07)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.15 (2021-08-01)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.14 (2021-07-25)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.13 (2021-07-19)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.12 (2021-07-11)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.11 (2021-07-11)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.10 (2021-07-04)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.9 (2021-06-25)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.8 (2021-06-22)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.7 (2021-06-20)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.6 (2021-06-11)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.5 (2021-05-31)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.4 (2021-05-25)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.3 (2021-05-19)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.2 (2021-03-07)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.1 (2021-03-03)

Note: Version bump only for package @aurelia/http-server

2.0.0-alpha.0 (2021-03-02)

Note: Version bump only for package @aurelia/http-server

0.9.0 (2021-01-31)

Features:

• di: remove DI.createInterface builder (8146dcc)

Bug Fixes:

• http-server: add platform initialization (b1ad799)

Refactorings:

• logging: replace $console config option with ConsoleSink (4ea5d22)
• http-server: convert to native modules (109b1fb)

0.8.0 (2020-11-30)

Bug Fixes:

• http-server: linting issue (2f77f10)
• http-server: accept header parsing (d468f2b)
• *: eslint issue (cd4e65f)
• *: deepscan issues (37f436d)
• *: correction (c0429ff)
• *: build failure (59ece95)
• *: streamlined the push state to a middleware (531fb39)
• *: quick fix for push state on file server (98b5805)
• *: cli arg parsing (edeeceb)

Refactorings:

• all: remove debug package (a1bdb60)
• logging: minor improvements (71e601b)