Upgrade to v3
Migrate from Unovis-powered nuxt-charts v2 to the vccs-powered nuxt-charts v3.
v3 swaps the rendering engine from Unovis to vccs (a Vue 3 port of Recharts) while keeping the config-prop API you already use — :data, :categories, :height, :y-axis, :curve-type, and friends. In most projects the upgrade is a dependency swap; your templates keep working.
next dist-tag. Install it as nuxt-charts@next in every app, package and workspace that depends on it — a plain nuxt-charts (or latest) still resolves to v2, so mixing the two leaves parts of a monorepo on the old Unovis engine.What stays the same
- The component names:
AreaChart,BarChart,LineChart,DonutChart,BubbleChart. - The config-prop API and the auto-imported enums/types (
CurveType,LegendPosition,Orientation,DonutType,BulletLegendItemInterface,AxisConfig,TooltipConfig, …). - Auto-imported, client-rendered, SSR-safe components.
- The
DonutChartcenter-content default slot (e.g. a%label in the middle of the ring).
What's new
- New chart types: Radar, Radial Bar, Funnel, Sankey, Candlestick and Status Tracker.
- New cross-cutting props on cartesian charts:
referenceLines,syncId,xExplicitTicks/yExplicitTicks, andminMaxTicksOnly. - Standalone module — no
vue-chrts/ Unovis peer dependencies.
Install
pnpm add nuxt-charts@next
npm install nuxt-charts@next
yarn add nuxt-charts@next
Run this in every workspace that lists nuxt-charts, and pin the next tag in each package.json (for example "nuxt-charts": "next") so installs and CI don't silently fall back to v2. In a pnpm monorepo, pnpm -r add nuxt-charts@next updates all packages at once.
vccs and motion-v ship as dependencies of the module — no extra install needed.
Configure
export default defineNuxtConfig({
modules: ["nuxt-charts"]
})
Removed in v3 (for now)
These specialty charts from v2 are not in the v3 engine yet:
| Component | Status |
|---|---|
DualChart | Planned for v3.1 (ComposedChart) |
GanttChart | Removed (Unovis-specific) |
DagreGraph | Removed (Unovis-specific) |
TopoJSONMap / DottedMap | Removed (no vccs map equivalent yet) |
If you still need those, stay on nuxt-charts v2 (nuxt-charts@2) for that project, or split specialty views into a separate app that keeps the legacy module.
Deprecated (inert) props
A handful of Unovis-only props have no vccs analog. They are kept on the type interfaces and marked @deprecated so existing templates still type-check — they simply have no effect: crosshairConfig, and on BarChart, stackAndGrouped / stackedGroupedSpacing (use stacked).