llms.txt

# Semiotic

> React data visualization library with schema-backed chart generation,
> streaming canvas rendering, server SVG rendering, coordinated views, and an
> MCP server.

Install: `npm install semiotic`
MCP server: `npx semiotic-mcp`
CLI: `npx semiotic-ai [--schema|--compact|--examples|--doctor|--audit-a11y]`

## Start Here

- [README](https://github.com/nteract/semiotic/blob/main/README.md): Product
  overview, installation, entry points, and MCP setup
- [Repository Instructions](https://github.com/nteract/semiotic/blob/main/AGENTS.md):
  Concise guidance for coding agents working in this repository
- [System Prompt](https://github.com/nteract/semiotic/blob/main/ai/system-prompt.md):
  Compact chart-generation guidance and behavior contracts
- [Component Schema](https://github.com/nteract/semiotic/blob/main/ai/schema.json):
  Machine-readable component and prop definitions
- [AI Reference](https://github.com/nteract/semiotic/blob/main/ai/reference.md):
  Comprehensive on-demand product reference
- [Examples](https://github.com/nteract/semiotic/blob/main/ai/examples.md):
  On-demand code patterns by chart and task
- [Changelog](https://github.com/nteract/semiotic/blob/main/CHANGELOG.md): Release
  history and migration notes

Prefer the system prompt plus one relevant component schema. Retrieve a nearby
example or the relevant reference section only when needed; do not load the
complete schema, examples, and reference by default.

## Package Entry Points

Use family subpaths for chart code: `semiotic/xy`, `semiotic/ordinal`,
`semiotic/network`, `semiotic/geo`, `semiotic/realtime`, `semiotic/physics`, and
`semiotic/value`. Use `semiotic/ai` or the lighter `semiotic/ai/core` for
generation and validation helpers, `semiotic/server` for static rendering,
`semiotic/recipes` for custom layouts, and `semiotic/themes` or
`semiotic/utils` for shared utilities.

Validate generated configurations with `prepareChart`,
`npx semiotic-ai --doctor`, or the MCP diagnostic tools. When a renderer is
available, confirm non-empty render evidence and run the accessibility audit.

The generated documentation catalog is available at
[semiotic.nteract.io/llms.txt](https://semiotic.nteract.io/llms.txt), with the
expanded reference at
[semiotic.nteract.io/llms-full.txt](https://semiotic.nteract.io/llms-full.txt).