# vega/vega-lite

A concise grammar of interactive graphics, built on Vega.

Repository: https://github.com/vega/vega-lite
Canonical: https://ross.abutalabs.com/products/vega-lite
Homepage: https://vega.github.io/vega-lite/
Language: TypeScript
License: BSD-3-Clause
License Family: permissive
Topics: visual-analysis, visualization-grammar, visualization, vega, charts, declarative-language, vega-lite, plot
Last push: 2026-08-24T21:09:57+00:00

## Health v2 (maintenance only)
Score: 89/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 69, longevity 100
- inputs: {"age_days": 4304, "days_push": 9, "days_rel": 131, "gap_med": 40.5, "n_releases_24m": 11}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5464, forks 717 (observed 2026-08-28T04:09:19.553075+00:00)

## What it is
Vega-Lite is a high-level declarative grammar of interactive graphics that compiles concise JSON specifications into complete Vega visualization specifications. It automatically handles axes, legends, scales, and supports data transformations, faceting, layering, and interactive selections.

## Use cases
- create charts from data with a concise declarative JSON syntax
- build interactive visualizations for data analysis dashboards
- quickly author bar charts, scatter plots, and line charts without low-level graphics code
- compose layered and multi-view visual displays with faceting and stacking
- embed interactive charts in web applications or notebooks
- generate visualization specifications programmatically for automated reporting

## When to choose
- you want concise, declarative chart specifications instead of imperative plotting code
- you need interactive visualizations with selections, tooltips, and linked views
- you want sensible defaults for axes, legends, and scales with the option to override
- you may later need the full power of Vega, since Vega-Lite compiles to Vega specifications

## When to avoid
- you need pixel-level control over custom or highly unusual visual marks
- you need maximum rendering performance for very large or real-time streaming datasets
- you prefer imperative plotting APIs like matplotlib or D3's direct DOM manipulation

## Facets
- artifact type: library
- maturity: stable
- function: data-visualization, charts
- domain: data-visualization, data-science, web-development, frontend
- platform: browser, cross-platform
- tags: declarative-visualization, vega, visualization-grammar, interactive-graphics, json-specification, typescript, nodejs, web-server

## Member repositories
- vega/vega-lite (main) score 89

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:19.553075+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:56:45.942744+00:00, confidence not recorded.
  - readme: https://github.com/vega/vega-lite (fetched 2026-08-28T04:09:19.553075+00:00, sha fc43a69cb287)
  - homepage: https://vega.github.io/vega-lite/ (fetched 2026-08-29T08:51:58.624886+00:00, sha 34055bdfed9b)
- Data as of 2026-08-30T08:39:29.467469+00:00.