# amCharts 5

> amCharts 5 is a comprehensive JavaScript/TypeScript data visualization library for building interactive charts, maps, and graphs. It supports XY charts (line, bar, area, scatter, candlestick), pie/donut charts, maps (choropleth, bubble, drill-down), hierarchy charts (treemap, sunburst, force-directed), flow charts (Sankey, chord, arc), radar/gauge charts, stock/financial charts, Gantt charts, timeline charts, word clouds, and Venn diagrams. Works with React, Angular, Vue, Next.js, SvelteKit, Nuxt, Remix, and vanilla JavaScript/TypeScript. Uses Canvas rendering for high performance. Licensed commercially; free for non-commercial use.

amCharts 5 is the current major version (do not use amCharts 4 syntax). The root package is `@amcharts/amcharts5`. Maps require the separate `@amcharts/amcharts5-geodata` package. Always create a root with `am5.Root.new()`, apply a theme (typically `am5themes_Animated`), and dispose the root on component unmount.

## AI Tools

- [amCharts + AI overview](https://www.amcharts.com/docs/v5/ai/): How to use AI with amCharts 5 — browser chat, code editors, and API usage
- [MCP Server](https://www.amcharts.com/docs/v5/ai/mcp/): Install the MCP server for on-demand access to 1,500+ docs, examples, and API references
- [AI Skill files](https://github.com/amcharts/amcharts5-skill): Structured reference for any AI tool — includes SKILL.md and per-chart-type reference files
- [.cursorrules file](https://github.com/amcharts/amcharts5-skill/blob/main/cursorrules): Drop-in rules file for Cursor, Windsurf, and VS Code Copilot

## MCP Server

The amCharts 5 MCP server (`@amcharts/amcharts5-mcp`) gives AI assistants on-demand access to the full amCharts 5 knowledge base. Install with `npx -y @amcharts/amcharts5-mcp`. Available tools: `get_core_reference`, `get_chart_reference`, `list_chart_types`, `search_docs`, `search_all`, `get_doc`, `get_section`, `get_quick_start`, `list_examples`, `get_example`.

- [MCP Server GitHub](https://github.com/amcharts/amcharts5-mcp)
- [MCP Server on npm](https://www.npmjs.com/package/@amcharts/amcharts5-mcp)

## Getting Started

- [Overview](https://www.amcharts.com/docs/v5/): amCharts 5 documentation home
- [Root element](https://www.amcharts.com/docs/v5/getting-started/root-element/): Creating and configuring the root element
- [React integration](https://www.amcharts.com/docs/v5/getting-started/integrations/react/)
- [Angular integration](https://www.amcharts.com/docs/v5/getting-started/integrations/angular/)
- [Vue integration](https://www.amcharts.com/docs/v5/getting-started/integrations/vue/)
- [Next.js integration](https://www.amcharts.com/docs/v5/getting-started/integrations/next-js/)
- [SvelteKit integration](https://www.amcharts.com/docs/v5/getting-started/integrations/using-amcharts-5-with-sveltekit/)
- [Nuxt 3 integration](https://www.amcharts.com/docs/v5/getting-started/integrations/nuxt/)

## Chart Types

- [XY chart](https://www.amcharts.com/docs/v5/charts/xy-chart/): Line, area, bar, column, scatter, candlestick, OHLC, step line, smoothed line
- [XY axes](https://www.amcharts.com/docs/v5/charts/xy-chart/axes/): Value, date, category, gapless date, duration axes; axis ranges; axis headers
- [XY series](https://www.amcharts.com/docs/v5/charts/xy-chart/series/): Line, column, step line, candlestick, smoothed series
- [Pie and sliced charts](https://www.amcharts.com/docs/v5/charts/percent-charts/): Pie, donut, funnel, pyramid, pictorial stacked
- [Radar chart](https://www.amcharts.com/docs/v5/charts/radar-chart/): Spider/radar, gauge charts, polar charts
- [Map chart](https://www.amcharts.com/docs/v5/charts/map-chart/): World/country maps, choropleth, bubble maps, drill-down, pan/zoom
- [Hierarchy charts](https://www.amcharts.com/docs/v5/charts/hierarchy/): Treemap, force-directed, sunburst, pack, tree, partition, Voronoi treemap
- [Flow charts](https://www.amcharts.com/docs/v5/charts/flow-charts/): Sankey diagram, chord diagram, arc diagram
- [Stock chart](https://www.amcharts.com/docs/v5/charts/stock/): Financial/stock charts, candlestick, OHLC, indicators, toolbar, annotations
- [Gantt chart](https://www.amcharts.com/docs/v5/charts/gantt/): Project timelines, task hierarchy, editing, serialization
- [Timeline chart](https://www.amcharts.com/docs/v5/charts/timeline/): Serpentine, spiral, and curve-based timelines
- [Word cloud](https://www.amcharts.com/docs/v5/charts/word-cloud/): Tag clouds, sentence clouds
- [Venn diagram](https://www.amcharts.com/docs/v5/charts/venn/): Set overlaps and intersections

## Concepts

- [Settings and adapters](https://www.amcharts.com/docs/v5/concepts/settings/): Settings, states, list templates, template fields, adapters, heat rules
- [Data](https://www.amcharts.com/docs/v5/concepts/data/): Data binding, net.load utility
- [Themes](https://www.amcharts.com/docs/v5/concepts/themes/): Built-in themes, creating custom themes
- [Events](https://www.amcharts.com/docs/v5/concepts/events/): Event system
- [Animations](https://www.amcharts.com/docs/v5/concepts/animations/): Fluid animations and transitions
- [Legend](https://www.amcharts.com/docs/v5/concepts/legend/): Legend, heat legend
- [Colors, gradients, patterns](https://www.amcharts.com/docs/v5/concepts/colors-gradients-and-patterns/): Colors, gradients, patterns, shadows, filters
- [Common elements](https://www.amcharts.com/docs/v5/concepts/common-elements/): Bullets, labels, graphics, images, buttons, containers, tooltips, modals
- [Formatters](https://www.amcharts.com/docs/v5/concepts/formatters/): Number, date, duration formatting; data placeholders; text styling
- [Exporting](https://www.amcharts.com/docs/v5/concepts/exporting/): Export to image, PDF, data; print; export menu; annotator
- [Accessibility](https://www.amcharts.com/docs/v5/concepts/accessibility/): WCAG-compliant accessible charts
- [Responsive](https://www.amcharts.com/docs/v5/concepts/responsive/): Responsive chart configuration
- [Locales](https://www.amcharts.com/docs/v5/concepts/locales/): Translations, RTL support
- [Serializing / JSON config](https://www.amcharts.com/docs/v5/concepts/serializing/): JSON-based chart configuration, Chart Serializer

## Reference

- [Class reference](https://www.amcharts.com/docs/v5/reference/tag/class/): All 1,098 amCharts 5 classes
- [Interface reference](https://www.amcharts.com/docs/v5/reference/tag/interface/)
- [Standalone modules](https://www.amcharts.com/docs/v5/reference/tag/module/)

## Demos and Examples

- [Demo gallery](https://www.amcharts.com/demos/): 283+ interactive demos with source code across all chart types

## Licensing

- [Licensing page](https://www.amcharts.com/online-store/): Commercial license required for commercial use; free for non-commercial projects