Highcharts React
Developmenthighcharts-reactHighcharts React is an Agent Skill for development published in the highcharts/highcharts-react repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use to implement, configure, and troubleshoot Highcharts in React projects. Trigger for Highcharts-related chart or data visualization work — when in doubt, use this skill if Highcharts is a candidate.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/highcharts/highcharts-react/blob/HEAD/.claude/skills/highcharts-react/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/highcharts-react, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Highcharts React (@highcharts/react)
Only use @highcharts/react — the official Highcharts React package. All others are legacy and incompatible.
Workflow
- Fetch docs for every concept before implementing.
- Check rules before implementing.
- Implement based on the fetched docs and rules.
Fetch docs before implementing
Fetch docs for every concept the query touches across all three tables in parallel — skipping any will cause broken implementations.
Topics
Chart element components
| Doc | Covers | URL |
|---|---|---|
| Title | Chart title | https://www.highcharts.com/docs/react/components/chart-elements/title |
| Subtitle | Chart subtitle | https://www.highcharts.com/docs/react/components/chart-elements/subtitle |
| Credits | Chart credits | https://www.highcharts.com/docs/react/components/chart-elements/credits |
| Legend | Chart legend | https://www.highcharts.com/docs/react/components/chart-elements/legend |
| PlotOptions | Shared series configuration | https://www.highcharts.com/docs/react/components/chart-elements/plot-options |
| Tooltip | Chart tooltip | https://www.highcharts.com/docs/react/components/chart-elements/tooltip |
| XAxis | X-axis configuration | https://www.highcharts.com/docs/react/components/chart-elements/x-axis |
| YAxis | Y-axis configuration | https://www.highcharts.com/docs/react/components/chart-elements/y-axis |
Module components
| Doc | Covers | URL |
|---|---|---|
| Accessibility module | Accessibility configuration | https://www.highcharts.com/docs/react/components/modules/accessibility |
| Boost module | Large dataset performance | https://www.highcharts.com/docs/react/components/modules/boost |
| BrokenAxis module | Axis breaks and gaps | https://www.highcharts.com/docs/react/components/modules/broken-axis |
| Data module | External data loading | https://www.highcharts.com/docs/react/components/modules/data |
| DraggablePoints module | Interactive point dragging | https://www.highcharts.com/docs/react/components/modules/draggable-points |
| Drilldown module | Nested chart navigation | https://www.highcharts.com/docs/react/components/modules/drilldown |
| Exporting module | Chart export and print | https://www.highcharts.com/docs/react/components/modules/exporting |
| StockTools module | Stock chart toolbar | https://www.highcharts.com/docs/react/components/modules/stock-tools |
Rules
- Never call imperative Highcharts methods — always update through React state to keep React and Highcharts states in sync.
- Never nest series components inside axis or option components — the library only resolves them as direct children of the chart root.
- Never use React hooks inside wrapped components — Highcharts React calls wrapper functions directly, outside React's rendering cycle, to minimize overhead. Define state in the parent and pass it via props instead.
- Always prefer JSX children over the
optionsprop for chart configuration to keep the code declarative and maintainable. - Always prefer dedicated series components over the generic
Seriesto keep the code maintainable — useSeriesonly for dynamic series. - Always prefer core Highcharts over full product bundles — import only the modules you need to optimize bundle size and performance.
- Always add
'use client'to files using Highcharts in projects using React Server Components — Highcharts requires a browser environment.
Imports
| What | From |
|---|---|
| Chart element components | @highcharts/react |
| Series components | @highcharts/react/series/<PascalCaseName> |
| Module components | @highcharts/react/modules/<PascalCaseName> |
| Additional modules | highcharts/es-modules/masters/modules/<module-name>.src.js |