A JavaScript API for Vega-Lite.

Usage no npm install needed!

<script type="module">
  import vegaLiteApi from '';


Vega-Lite API

Build Status

Gallery Image

A JavaScript API for creating Vega-Lite JSON specifications. Vega-Lite is a high-level grammar for visual analysis that generates complete Vega specifications.

With the Vega-Lite API, you can write JavaScript code like this:


To produce Vega-Lite JSON like this:

  "mark": "bar",
  "data": {"url": "data/movies.json"},
  "encoding": {
    "x": {
      "bin": true,
      "field": "IMDB_Rating",
      "type": "quantitative"
    "y": {
      "aggregate": "count",
      "type": "quantitative"

To get started with the Vega-Lite API, see these Observable notebooks:

Build Instructions

For a basic setup allowing you to build the API and run tests:

  • Clone
  • Run yarn to install dependencies for all packages. If you don't have yarn installed, see
  • Once installation is complete, run yarn build to build the API generator and generate API source code in the src directory. Run yarn test to additionally run the test suite.

API Reference

See the Vega-Lite JavaScript API Reference.