A new star on the rise

nebula.js is a collection of JavaScript libraries and APIs that helps developers integrate visualizations and mashups on top of Qlik's Associative Engine.

It consists of three parts:

• nucleus: A product and framework agnostic JavaScript library for building mashups.
• supernova: A JavaScript API for consuming and visualizing QIX data.
• cli: Tools to help you create, develop and build a supernova.

Since nebula.js 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

• nucleus
  • theming (#24)
  • translations, localization (#25)
  • error handling
  • export (#26)
• supernova
  • 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)

• 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

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

npx @nebula.js/cli@next create hello-sunshine

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

npm install @nebula.js/cli@next -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.

Please follow the instructions in our contributing guide.