ggts
Navigate
On this page

Production

Responsive sizing

Omit width: GGPlot observes its container. Positive-width block, no chart CSS. Omitted height: 400px default. Collapsed parent, hidden tab, or zero-width track → not-ready until ResizeObserver reports positive width. Do not paper over that with a fake fixed width. Troubleshooting.

SSR uses an 832×400 deterministic fallback and stays not-ready in HTML until hydration measures the real container. Reserve layout space to avoid CLS.

Rendering

Renderer follows mark density and interaction needs. Axes, legends, labels, and a11y chrome stay semantic regardless of SVG vs canvas.

SVG: DOM marks. Canvas: dense strata. Auto: switches above the published threshold (CANVAS_AUTO_THRESHOLD) and emits canvas-auto. Force with layer "render": "canvas" or render="canvas"; axes, legends, and a11y chrome stay SVG.

Inspection and selection use the model-owned candidate store, not DOM hit tests. Stable keys keep identity across SVG/canvas; renderer indices never appear in public callbacks. Measure with repo fixtures before forcing canvas globally. For a real-data scatter surface, see scatter color.

Server and export

One PortableSpec: React or Svelte SSR, pure renderToSVGString, CLI.

import { registerAll, renderToSVGString } from "@ggts-sh/core";

// Headless full-grammar rendering (#1420): explicit opt-in.
registerAll();

const svg = renderToSVGString(spec, { width: 640, height: 400 });
# npm install -g @ggts-sh/cli
ggts check spec.json
ggts render spec.json > chart.svg

SVG on stdout; JSON Lines diagnostics on stderr — the agent feedback loop. CLI reference.

Compatibility

Every release is tested as an installed package: clean install, strict type-check, client build, server render, pure Node render, and the ggts CLI.

  • Node.js >=22 (22 and 24 in CI; 26 nightly)
  • React DOM ^18.2.0 || ^19.0.0 (tested floor 18.2.0, current 19.2.0)
  • Svelte ^5.33.1 (tested floor 5.33.1, current 5.56.5)
  • npm bundled with Node, pnpm 11.13.0, Bun 1.4.2
  • Chromium, Firefox, and WebKit (Playwright 1.61.1)
  • Ubuntu and Windows in CI; macOS nightly

Exact machine-checked rows live in support-matrix.json. Bun is the contributor toolchain only; consumers can use any installer above.

Docs