Take a look at the documentation site to browse documentation for all releases of this artifact.
Middleware for your web client: Create maintainable applications from small, isolated parts.
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.
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
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.
Using the Generator
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.
Hacking LaxarJS itself
Instead of using the compiled library within a project, you can also clone this repository:
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:
npm run dist
To run the automated tests:
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:
Now you can select a spec-runner by browsing to http://localhost:8080/dist/lib/.