NebulaJS is a collection of JavaScript libraries, charts and CLIs that helps developers build and integrate visualizations on top of Qlik's Associative Engine. The collection is organized under the @nebula.js npm scope.

The primary package is @nebula.js/stardust which contains APIs for integrating existing visualizations into mashups, as well as APIs for building custom visualizations.

Roadmap

Since stardust is still in an early stage we are very much open to input and suggestions. If you think something is missing, an API is weird or have general opinions about anything, let us know.

Your opinions, requirements and involvement is key to the success of this project. Click on the linked issues below (or create you own), voice your opinion and vote if you would like to see it get implemented.

This is a draft of the roadmap ahead:

Documentation

This is the primary task right now as there is currently barely any documentation at all 😬.

Integration APIs

stardust
- theming (#24)
- translations, localization (#25)
- error handling
- export (#26)
- consume theme (#27)
- consume translator (#28)
- actions api
- options api
- context menu (#41)
- take and consume snapshot (#29)
- versioning (#39)
- hooks (#30)
- deduce data targets from properties
- type definitions (#40)

CLI

create
- more templates (#31)
build
- support more loaders (#32)
serve
- assets (#35)
- printing/export (#33)
- generate property panel from properties (#34)
- ui overlay on failure (#36)
- developer hints
- theme editor (#37)
sense
- generate property panel definition based on initialProperties
- adapt Sense theme to nebula (#38)

Try it out

Prerequisites

node.js v8.0.0+
Access to Qlik Associative Engine
- which comes bundled with one of the following products
  - Qlik Sense Desktop
- or by running it in a Docker container through either
  - Qlik Core
  - or the qlikcore/engine image

Creating a new project

The easiest way to get started is to create a new project using the nebula CLI through npx:

npx @nebula.js/cli create hello-sunshine

or by doing a global install and running the nebula command:

npm install @nebula.js/cli -g
nebula create hello-sunshine

This will create a directory called hello-sunshine with the following content:

hello-sunshine
├─ README.md
├─ package.json
├─ .editorconfig
├─ .eslintrc.json
├─ .gitignore
└─ src
   ├─ index.js
   └─ object-properties.js

The package.json contains a few built-in npm commands:

npm start

Starts a web development server.

The server needs to connect to a running instance of Qlik Engine and by default assumes it's already running on port 9076. If you don't have Qlik Sense desktop installed you can opt-in to start a Docker image of Qlik Engine by accepting the Qlik Core EULA:
```
cross-env ACCEPT_EULA=yes npm start
```
npm run build

Builds the supernova for production into the dist folder. At this stage you can publish the supernova to npm using the command npm publish.
npm lint

Checks for code syntax issues.

Contributing

Please follow the instructions in our contributing guide.

Resources

name	status	description
sn-mekko-chart		Mekko chart