aurelia-bootstrapper

This library is part of the Aurelia platform and contains the bootstrapper which sets up the default configuration for the aurelia framework and gets you up and running quick and easy.

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 look around our Discourse forums, chat in our community on Discord or use stack overflow. Documentation can be found in our developer hub.

Platform Support

This library can be used in the browser only.

Building The Code

To build the code, follow these steps.

1. Ensure that NodeJS is installed. This provides the platform on which the build tooling runs.

2. From the project folder, execute the following command:

   npm ci
   

3. To build the code, you can now run:

   npm run build
   

4. You will find the compiled code in the dist folder, available in three module formats: AMD, CommonJS and ES6.

Running The Tests

To run the unit tests, first ensure that you have followed the steps above in order to install all dependencies and successfully build the library. Once you have done that, proceed with these additional steps:

1. You can now run the tests with this command:

   npm run test
   

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

2.4.1 (2024-04-19)

Bug Fixes

• avoid an edge case that process was stubbed without process.browser property (#96) (f6dfdf7), closes #71 #72

2.4.0 (2022-04-19)

Bug Fixes

• deps: resolve vulnerable dep issue (45dcea1)

2.3.4 (2019-03-27)

2.3.3 (2019-02-04)

2.3.2 (2019-01-26)

Bug Fixes

• avoid unnecessary pal loading when pal is already initialized (429c261), closes aurelia/cli#1019

2.3.1 (2018-12-01)

Bug Fixes

• loader: Use better detection of amd loaders (1b98576)

2.3.0 (2018-07-02)

2.1.1 (2017-03-06)

Bug Fixes

• Edge: Chakra/Edge bug when using ES2015 (9d0917b)

2.1.0 (2017-03-01)

Bug Fixes

• startup: starting promise fullfils too early (020e851)

2.0.1 (2016-12-14)

Bug Fixes

• Properly detect NWJS

2.0.0 (2016-12-08)

Bug Fixes

• index: do not fail when process is polyfilled by Webpack (7ba0654)
• index: do not trip up on NodeJS if PAL was previously initialized (c70321d)
• index: higher quality checks for SystemJS and AMD (71a91f2)
• index: ready when no document (not initialized on NodeJS) (44b0e55)
• index: use module.require for node to trip up webpack's parser (46830fa)
• index: use webpack require to hide from amd (cdaa0f2)

Features

• all: rework the bootstrapper to detect and load the proper pal (8ba596b)
• index: add starting promise export (1844827)
• index: add support for module loader detection (438ffde)

[1.0.1]

Bug Fixes

• bootstrapper: Check module function configure before execute it

1.0.0 (2016-07-27)

1.0.0-rc.1.0.1 (2016-06-30)

Features

• index: pass config module id along to aurelia instance if present (51a698c)

1.0.0-rc.1.0.0 (2016-06-22)

1.0.0-beta.1.2.1 (2016-05-10)

1.0.0-beta.1.2.0 (2016-03-22)

• Update to Babel 6

1.0.0-beta.1.1.4 (2016-03-01)

1.0.0-beta.1.1.3 (2016-03-01)

Bug Fixes

• all: remove core-js (60ef61a5)

Features

• index: use aurelia polyfills (c77c982b)

1.0.0-beta.1.1.2 (2016-02-08)

Bug Fixes

• index: remove check for localhost (0f769f4b)
• lint: fix eslint config (a25b4b4e)

1.0.0-beta.1.1.0 (2016-01-29)

Bug Fixes

• index: change loader detection to work in more environments (9a5c169a)

Features

• all: update jspm meta; core-js; aurelia deps (65079e91)

1.0.0-beta.1.0.2 (2016-01-08)

Bug Fixes

• index: compose promises (75f1a33b)

1.0.0-beta.1.0.1 (2016-01-08)

Bug Fixes

• all: switch requirejs/system.js check order (383161e9, closes #26)

Features

• all: switch normalizeSync to normalize api (35e4b10e)

1.0.0-beta.1 (2015-11-16)

0.19.0 (2015-11-10)

0.18.0 (2015-10-13)

Bug Fixes

• all:
  • address issues with incorrect code in the last PR; update to more ES6 syntax (63a5bea3)
  • detect fake system and remove core-js dup load (f135ad39)
  • break out the history from the router plugin config (864cf2c2)
  • root should default to aurelia-app host when not specified (ed3b7124, closes #5)
  • update to logLevel enum name api change (64d8edf3)
  • use default loader (8acf5996)
• bootstrapped:
  • ensure that templating resources are in System.map (fb6ad861)
  • bad import name for RouterView (6590f2cf)
• bootstrapper:
  • remove catch handlers that kill stack traces during startup (e867ca1f)
  • removees5-specific helper detection (d55802b2)
  • change how default loader is discovered (13b04160)
  • ensure di is available as top level import (3f50f876)
  • update setRoot to remove transition (98cea82e)
  • ensure that aurelia-logging-console is available (53ef67d0)
  • invalid loader name (562b17b3)
• build:
  • missing gulp-rename dep (3d4bb04d)
  • d.ts generation and doc generation (43dba2b7)
  • update linting, testing and tools (b0fcc33b)
  • add missing bower bump (e72cf895)
• index:
  • switch to console when logger not loaded (145bd3f2)
  • correct core-js import syntax and fix lint errors (7831d8f3)
  • remove html import polyfill load (8d99882d)
  • detect System or require api and load appropriately (2fa4d3e7, closes #110)
• package:
  • change jspm directories (f82ca368)
  • update dependencies (f3435bf8)
  • update deps and fix bower semver ranges (8754ff0e)
  • update dependencies (a8811da7)
  • update Aurelia dependencies (37aeca13)
  • update dependencies to latest (57c487a0)
  • update loader-systemjs to latest version (09131833)
  • update dependencies to latest (ba1a63db)
  • update dependencies to latest (0fecdbc9)
  • update dependencies to latest (21c8d229)
  • update dependencies to latest versions (7402bbb8)
  • update dependencies to latest versions (06ede457)
  • update dependencies to latest versions (1a6ecd09)
  • update dependencies to latest versions (1cb2d30e)
  • update dependencies to latest versions (24d6d675)
  • update dependencies to latest versions (70c91a0c)
• preparePlatform: correct spelling (010f0a9a)

Features

• all:
  • incorporate pal (3935af79)
  • remove static imports and use new loader apis to remove global System (67993548)
  • add more type info (d593ee59)
  • remove AtScript support (65134367)
  • update compiler and core-is integration (52d84e7a)
  • update to new plugin api (50fc5ce6)
• bootstrapped: switch router and resources over to plugin model (aa93bce4)
• bootstrapper:
  • new startup logic (373bf740)
  • identify polyfilled system and skip core-js (76fab9a1)
  • switch to core-js (166c13d6)
  • add plugin helper for event aggregator (6df89100)
  • add plugin helper for binding language (82a86ffc)
  • add plugin helpers for router and resources (fcb3ac34)
• build: update compiler and switch to register module format (b5619c13)
• index: removed some code that was relocated to aurelia itself (17ca281d)
• polyfills: automatically detect and load polyfills as needed (f57132c8)

0.17.0 (2015-09-05)

Bug Fixes

• all: address issues with incorrect code in the last PR; update to more ES6 syntax (63a5bea3)
• build:
  • d.ts generation and doc generation (43dba2b7)
  • update linting, testing and tools (b0fcc33b)
• index: remove html import polyfill load (8d99882d)

0.16.0 (2015-08-14)

Features

• all: add more type info (d593ee59)

0.15.0 (2015-08-05)

Features

• index: removed some code that was relocated to aurelia itself (17ca281d)

0.14.1 (2015-07-29)

• improve output file name

0.14.0 (2015-07-02)

Bug Fixes

• all: detect fake system and remove core-js dup load (f135ad39)

0.13.1 (2015-06-09)

Bug Fixes

• index: detect System or require api and load appropriately (2fa4d3e7, closes #110)

0.13.0 (2015-06-08)

Bug Fixes

• all: break out the history from the router plugin config (864cf2c2)
• bootstrapper: remove catch handlers that kill stack traces during startup (e867ca1f)

0.12.0 (2015-05-01)

Bug Fixes

• all:
  • root should default to aurelia-app host when not specified (ed3b7124, closes #5)
  • update to logLevel enum name api change (64d8edf3)
• bootstrapper: removees5-specific helper detection (d55802b2)
• preparePlatform: correct spelling (010f0a9a)

0.11.0 (2015-04-09)

Features

• all:
  • remove AtScript support (65134367)
  • update compiler and core-is integration (52d84e7a)

0.10.0 (2015-03-25)

Bug Fixes

• bootstrapper: change how default loader is discovered (13b04160)

Features

• bootstrapper: new startup logic (373bf740)

0.9.5 (2015-02-28)

Bug Fixes

• package: change jspm directories (f82ca368)

0.9.4 (2015-02-28)

Bug Fixes

• build: add missing bower bump (e72cf895)
• package: update dependencies (f3435bf8)

0.9.3 (2015-01-29)

Features

• bootstrapper: allow for bootstrapping from the main module

0.9.2 (2015-01-24)

Bug Fixes

• bootstrapped: ensure that templating resources are in System.map (fb6ad861)

0.9.1 (2015-01-24)

Bug Fixes

• package: update deps and fix bower semver ranges (8754ff0e)

0.9.0 (2015-01-22)

Bug Fixes

• all: use default loader (8acf5996)
• package: update dependencies (a8811da7)

Features

• all: update to new plugin api (50fc5ce6)
• bootstrapper: identify polyfilled system and skip core-js (76fab9a1)

0.8.0 (2015-01-12)

Bug Fixes

• package: update Aurelia dependencies (37aeca13)

0.7.0 (2015-01-07)

Bug Fixes

• package: update dependencies to latest (57c487a0)

0.6.1 (2015-01-06)

Bug Fixes

• package: update loader-systemjs to latest version (09131833)

0.6.0 (2015-01-06)

Bug Fixes

• bootstrapper: ensure di is available as top level import (3f50f876)

Features

• bootstrapper:
  • switch router and resources over to plugin model (aa93bce4)
  • switch to core-js (166c13d6)
  • add plugin helper for event aggregator (6df89100)
  • add plugin helper for binding language (82a86ffc)
  • add plugin helpers for router and resources (fcb3ac34)
• build: update compiler and switch to register module format (b5619c13)

0.5.2 (2014-12-22)

Bug Fixes

• package: update dependencies to latest (ba1a63db)

0.5.1 (2014-12-22)

Bug Fixes

• package: update dependencies to latest (0fecdbc9)

0.5.0 (2014-12-22)

Bug Fixes

• bootstrapper:
  • update setRoot to remove transition (98cea82e)
  • ensure that aurelia-logging-console is available (53ef67d0)
• package: update dependencies to latest (21c8d229)

0.4.3 (2014-12-18)

Bug Fixes

• package: update dependencies to latest versions (7402bbb8)

0.4.2 (2014-12-18)

Bug Fixes

• package: update dependencies to latest versions (06ede457)

0.4.1 (2014-12-17)

Bug Fixes

• package: update dependencies to latest versions (1a6ecd09)

0.4.0 (2014-12-17)

Bug Fixes

• bootstrapper: invalid loader name (562b17b3)
• package: update dependencies to latest versions (1cb2d30e)

0.3.1 (2014-12-12)

Bug Fixes

• bootstrapped: bad import name for RouterView (6590f2cf)

0.3.0 (2014-12-12)

Bug Fixes

• package: update dependencies to latest versions (24d6d675)

Features

• polyfills: automatically detect and load polyfills as needed (f57132c8)

0.2.0 (2014-12-11)

Bug Fixes

• package: update dependencies to latest versions (70c91a0c)