Command-line reference

ggsvelte-render reads PortableSpec JSON and writes deterministic SVG. Its option list below comes from the same package-private registry as argument parsing and --help.

Input and output

Pass one JSON file or omit it to read stdin. SVG is the only stdout output.

ggsvelte-render spec.json > chart.svg 2> diagnostics.jsonl

Errors, warnings, and advisories are JSON Lines on stderr.

Options

--width N

Plot width in px (default: spec.width, then 832).

--height N

Plot height in px (default: spec.height, then 400).

--data FILE

JSON file with named datasets.

{"name": rows|columns|{values}|{columns}}

--max-marks N

Refuse to render more marks than N (default 100000).

--version

Print the installed @ggsvelte/svelte version.

--help

Show this help.

Alias: -h.

Exit codes

0

Rendered successfully.

1

The pipeline or renderer failed after structural validation.

2

Usage, input, file, or JSON parsing failed.

3

The PortableSpec failed validation.

Troubleshooting

Keep stdout and stderr separate. Search the source-qualified code in the Errors reference, correct the input, and rerun the same command.