Installation

Get started with Nuxt Charts v3.

1. Install dependencies

Use your preferred package manager:

pnpm add nuxt-charts@next
v3 renders through vccs (no Unovis / vue-chrts peers), keeps the same config-prop API, and adds Radar, Radial Bar, Funnel, Candlestick and Status Tracker charts. Migrating from v2? See Upgrade to v3.
Vue (non-Nuxt) apps can keep using vue-chrts for now. See Vue Charts. The Nuxt module is standalone and does not depend on it.

2. Configuration

Add the module to your nuxt.config.ts:

nuxt.config.ts
export default defineNuxtConfig({
  modules: ["nuxt-charts"]
})

3. Test installation

<script setup lang="ts">
const data = [
  { month: 'Jan', sales: 100, profit: 50 },
  { month: 'Feb', sales: 120, profit: 55 },
  { month: 'Mar', sales: 180, profit: 80 },
  { month: 'Apr', sales: 110, profit: 40 },
  { month: 'May', sales: 90, profit: 30 },
]

const categories = {
  sales: {
    name: 'Sales',
  },
  profit: {
    name: 'Profit',
  },
}

const xFormatter = (i: number) => data[i].month
</script>

<template>
  <LineChart
    :data="data"
    :categories="categories"
    :height="300"
    :xFormatter="xFormatter"
    xLabel="Month"
    yLabel="Amount"
  />
</template>

4. Customize CSS variables

If your app uses Nuxt UI v4, v3 automatically follows its semantic colors, surfaces, text, borders, radius, font, and dark mode. Without Nuxt UI, complete standalone defaults are used. In either case you can override the public --vc-* tokens on the chart root. See Theming.

/assets/css/main.css
.vue-chrts {
  --vc-tick-color: var(--ui-text-muted);
  --vc-grid-color: var(--ui-border);
  --vc-tooltip-bg: var(--ui-bg-elevated);
  --vc-legend-color: var(--ui-text-muted);
}

Library Comparison

When searching for the right charting solution, it's important to understand how different libraries stack up.

FeatureNuxt Charts v3Chart.jsUnovis
RenderingSVG (vccs)CanvasSVG (native)
Type Safety✅ Full TypeScriptPartial✅ Full TypeScript
Style SystemTailwind / Nuxt UICustom CSSFramework-agnostic
SEO Ready✅ Yes❌ Limited✅ Yes
Best ForModern Nuxt appsLegacy/Simple AppsComplex Unovis dashboards