The scaffolding repo for Aurelia 2 used by the makes tool to create new Aurelia 2 projects.

First, ensure that you have Node.js v18 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 tool, along with the aurelia scaffold from this repo, which it will use to guide you through creating your project.

This scaffold supports two modern bundlers:

• Vite (Recommended) - Next-generation frontend tooling with Rolldown support for blazing-fast builds
• Dumber - Lightweight Aurelia-native bundler, successor to the Aurelia CLI built-in bundler

There are some tests for this skeleton, setup in package.json. (totally not required by makes)

Unit tests for various "makes" files.

npm test

E2E tests for skeletons.

GitHub Actions runs a subset of them for every PR or push to master.

# Do not run following directly. There are too many skeletons.
npm run test:e2e

Always target a subset of skeletons, use env variable TARGET_FEATURES.

# only test skeletons using vite and typescript features.
npx cross-env TARGET_FEATURES=vite,typescript npm run test:e2e

# or test dumber skeletons
npx cross-env TARGET_FEATURES=dumber,typescript npm run test:e2e

If you forked this repo, you can try your skeleton with:

# Try your master branch if your forked name is "new"
npx makes your_GitHub_name
# Try some branch or commit or tag
npx makes your_GitHub_name/forked_repo_name#some-branch

MIT.