Building large applications is hard, so don't do that!
npm install laxar> _Note:_ This project is no longer being actively maintained.
> Feel free to create a fork if you would like to continue using and/or developing the software.
Take a look at the documentation site to browse documentation for all releases of this artifact.
Find out why you would use LaxarJS and if it's the right tool for you.
Then, explore the core concepts and browse the manuals in the documentation.
Also, there is a glossary where you can lookup individual concepts, and a troubleshooting guide there for you if you need it.
Have a look at the LaxarJS website for demos and more information.
Take a look at the documentation site to browse documentation for all releases.
Here are the basic instructions to get started.
On your _development machine_, make sure that you have Node.js v6 or above (v4 might work, but there is no support).
Users of your application will need to have the following _browser capabilities:_
- native ES5 support (no polyfills: MSIE < 9 is not supported)
- Support for the following ES6 features (native or polyfilled):
- Promise, Fetch
- Array.from, Array.prototype.includes
- Object.assign
Modern browsers have support for all of these, but polyfills for the listed ES6 features can be obtained by simply loading the LaxarJS polyfills bundle (dist/polyfills.js) using a script tag, before loading anything else.
When using the generator (next step), your project will be setup for use with polyfills automatically.
Use the generator-laxarjs2 for the Yeoman scaffolding tool to get started:
``console`
npm install -g yo generator-laxarjs2
mkdir my-app
cd my-app
yo laxarjs2
This will guide you through a couple of prompts in order to create your first application.
There is a step-by-step tutorial containing a more detailed example.
Using the generator is the recommended way of creating a LaxarJS application.
However, knowledge about the _manual_ project setup process is useful for a better understanding of LaxarJS and may help in some advanced use cases, such as migrating a project from a previous major version.
There are detailed instructions to create a project from scratch.
Instead of using the compiled library within a project, you can also clone this repository:
`console`
git clone https://github.com/LaxarJS/laxar.git
cd laxar
npm install
To see changes in your application, either configure your project to work with the sources (e.g. by configuring a webpack alias), or _rebuild the bundles_:
`console`
npm run dist
To run the _automated tests_:
`console`
npm test
To generate HTML test runners for opening in your web browser, so that you can e.g. use the browser's developer tools for diagnostics:
`console``
npm start
Now you can select a spec-runner by browsing to http://localhost:8080/dist/lib/.