's software development kit (SDK)

npm install
7 downloads in the last day
7 downloads in the last week
77 downloads in the last month Build Status Gitter chat

API Docs Docs Issues Contributing About
i2 i1 i6 i4 i5 logo is a Software Development Kit (SDK) responsible for communication between a client using the SDK and the server. If you don't have a server running yet, get one up and running in minutes or open a free account with

The SDK can consume ANY endpoint of the framework, however for brevity purposes, the API manual below includes only the main topics of:

  • Pushing data is done by sending an array of JSON documents for storage in cache.
  • When Querying, you describe the data you wish to consume and shape it to your liking.
  • Transform your data into insight using Data Visualization.

Getting the SDK

Option 1: Include in your HTML.

<script src="http://localhost:8080/"></script>

Optional: if you'll include ?APIToken=XXXXXX, you'll be able to use without calling init.

Option 2: Require the SDK require('');

$ npm install
var joolaio = require('');

Quick Example

<!DOCTYPE html>

<div id="metric-visits"></div>

<script src="http://localhost:8080/"></script>
<script>'ready', function () {
    joolaio.beacon.insert('visits', {username: 'thisisme', visits: 1});
    new joolaio.viz.Metric({
      container: '#metric-visits',
      query: {
        timeframe: 'last_hour',
        interval: 'minute',
        dimensions: [],
        metrics: ['visits']

Learn more about using the SDK


We would love to get your help! We have outlined a simple Contribution Policy to support a transparent and easy merging of ideas, code, bug fixes and features.

If you're looking for a place to start, you can always go over the list of open issues, pick one and get started. If you're feeling lost or unsure, just let us know.


Contacting us is easy, ping us on one of these:


Copyright (c) 2012-2014 Joola Smart Solutions. GPLv3 Licensed, see LICENSE for details.

npm loves you