Vega: A Visualization Grammar

Vega is a visualization grammar, a declarative format for creating, saving, and sharing interactive visualization designs. With Vega you can describe data visualizations in a JSON format, and generate interactive views using either HTML5 Canvas or SVG.

For documentation, tutorials, and examples, see the Vega website. For a description of changes between Vega 2 and later versions, please refer to the Vega Porting Guide.

Install

Use npm or yarn to install Vega for use in third-party libraries or applications.

Using npm:

npm install vega

or using yarn:

yarn add vega

If you would like to install the Vega command line utilities (vg2pdf, vg2png, vg2svg), see the vega-cli package.

Contributions, Development, and Support

Interested in contributing to Vega? Please see our contribution and development guidelines, subject to our code of conduct.

Looking for support, or interested in sharing examples and tips? Post to the Vega discussion forum or join the Vega slack organization!

Read about future plans in our roadmap.

Package Development

This package builds the bundled Vega library files and the JSON schema. It also includes a high-level test suite. If performing local development:

• Run yarn build to build both browser and node.js bundles.
• Run yarn test to run the test suite.