Skip to main content

Installing and Running Examples


To install the framework:

npm install --save


yarn add

The module includes all features and their dependencies. If you want to selectively install a subset of the features, see the Dependencies section below.

Running the Examples

The repository contains an examples folder with a selection of small, standalone examples that could be good starting points for your application.

You should be able to copy these folders to your preferred locations, and get them running simply as follows:

Clone the repo, if you haven't already

git clone

For most consistent results, it is recommended that you check out the latest release branch (e.g. 8.0-release) instead of master when running examples.

git checkout 8.0-release

Change directory to the example you are interested in, e.g.


Then install dependencies using the installer of your choice:

npm install
# or

and then running using:

npm start

If the example uses a mapbox base map you need a Mapbox access token

export MapboxAccessToken={Your Token Here} && npm start

If you want to build the example against the latest source code in the cloned repo (rather than the published version of listed in the examples package.json)

npm run start-local

The examples on the master branch are updated to use features from the latest, unreleased version of If some example doesn't work using npm start it can be worth trying npm run start-local.

While all examples support npm run start-local, there are some caveats when running against local source. Most importantly, you must make sure to run npm install or yarn in the root folder before running npm run start-local in an example folder.

Selectively Install Dependencies

A family of NPM modules are published as part of the framework. The following tree shows their scope and dependencies:

  • - Core module that handles the GPU rendering pipeline, data management, and user interaction
    • - Primitive layers that are the building blocks of all visualizations
      • - Advanced layers that aggregate data into alternative representations, e.g. heatmap, contour, hex bins, etc.
      • - Additional layers that handle geospatial use cases and GIS formats.
      • - Additional layers that render 3D meshes and scene graphs.
    • - Declarative interface that supports specifying layers and views using a JSON format.
    • - An integration with the Mapbox custom layer API.
    • - React wrapper of
    • - Useful UI components.
    • - Testing utilities.

For example, to render a PointCloudLayer, you may install:

yarn add

To use the HexagonLayer with React, you need to install:

yarn add

While installing submodules separately affords applications the maximum control over the dependencies that it pulls in, the submodule versions are expected to be synchronized manually in order to produce consistent results.

The master module includes all submodules except for Most bundling solutions (Webpack, Rollup etc.) offer tree-shaking capabilities that exclude unused exports from a production build.