V

Welcome to Vuer-Viz

Publication-quality visualization components for React, following matplotlib styling conventions.

Quick Start

Install Vuer-Viz using npm or pnpm:

npm install @vuer-ai/vuer-viz
# or
pnpm add @vuer-ai/vuer-viz

Your First Chart

Each LineSeries contains parallel numeric x and y arrays of equal length. The example below is rendered from the same typed source shown by its code button.

My First Chart00.20.40.60.8100.20.40.60.81
sin(x)
x (radians)y
import { LineChart, type LineSeries } from '@vuer-ai/vuer-viz';

const x = Array.from({ length: 50 }, (_, i) => (i / 49) * 2 * Math.PI);
const series: LineSeries[] = [
  { label: 'sin(x)', x, y: x.map(Math.sin), color: '#0000ff' },
];

export default function FirstChart() {
  return (
    <LineChart
      series={series}
      title="My First Chart"
      xLabel="x (radians)"
      yLabel="y"
      grid
      legend
    />
  );
}

This creates a professional, publication-ready chart at 325x220px with:

  • Matplotlib-style appearance
  • Times New Roman font
  • Configurable grid lines
  • Major and minor tick marks
  • Clean, minimal design

Key Features

  • Publication Quality - Export-ready charts designed for papers and presentations
  • Matplotlib Styling - Familiar conventions for data scientists and researchers
  • Flexible Components - Line charts, bar charts, images, videos, and more
  • Dark Mode - Beautiful appearance in both light and dark themes

What's Available

Chart Types

  • Line Charts - Smooth curves with customizable series and legends
  • Parallel Axis - Compare continuous and categorical dimensions
  • Heatmaps - Display a matrix with color scales
  • Bar Charts - Vertical and horizontal bars with grid support
  • Images - Display images with captions and positioning
  • Videos - Video playback with pattern support
  • Text - Markdown and code with syntax highlighting
  • README - Render markdown files with TOC support
  • ANSI Terminal - Terminal output with color codes

Guides

Next Steps