NOTE: This project is still in heavy development and is not ready for actual use at this time. Releasing to the open source community is aimed at getting feedback and help from the community.
Install LuxUI as a dependency in your project:
$ npm install --save @luxui/luxReact
Projects using LuxUI must provide two configuration settings: an API root URI
apiRoot) and a location to render the application to (
renderRoot). The API
root URI should be an absolute URI to the root resource of the API "backing"
the application. The render location should be a
id of a DOM resource that
the implementation code will be able to "own" for application rendering.
Then you will be able to use LuxUI in your application(s):
;const app =;app;
Some applications will have a need for pages that aren't represented in the API as resources. LuxUI provides a way to register specific URLs that will be handled by a custom handlers. Once you have defined the implementation specific handler the way pages are registered are as follows:
;;const app =;app;
All pages will make an API call to the root resource of that API for meta information - such as main menu links, login status, etc. - and will then receive a responseModel object of that request.
For more information about what responses from the API should be and why read through the API Implementation Guide.
If you would like to get involved in the development of the project we would appreciate your help; please review the Contributing Guide and browse the open Pull Requests and Issues for ideas on where to focus.
An ultimate goal of LuxUI is to make the following statement completely true:
"The API is in control of everything."
The tactics that LuxUI employs to accomplish this goal are:
- Standardized data contract (Siren+lux)
- No "shared knowledge" between "backend" and "frontend".
- Document all application logic in API responses.
- The API has independent control of: workflow, access control, etc.
- UI customization
- Plugins allow for specialized domain solutions.
- Static content pages in-app rather than contrived API resources.
- Full control and access to CSS.
- Create a reason for APIs to become standardized in response format.
- Give non-UI developers control of the UI in a familiar way; API data.
- Enable UI developers to build more general-purpose web components.
- Stop building custom single-use UI elements.
- Working towards a consistent UX across many applications.
- Make moving between projects a consistent experience.
- Intelligently decouple rendering responsibilities and business logic.
- Enable updates to many applications in a consistent, scheduled, repeatable, and safe way.
- Allow for independent evolution of API and UI elements.
- Isolate testing requirements.
These will be the supported versions; at this time there is no specific browser testing or validation. If you find problems please report them as issues.
- Chrome - current, and current - 1
- MS - Edge; IE > 9 (newer than IE9)
- Firefox - current, and current - 1
- Safari - current, and current - 1