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.
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
- Chart Layout - Understanding chart anatomy and customization
- Canvas Rendering - Fast rendering for large datasets
- Event Handling - Interactive charts with hover and click
- Markers & Ranges - Highlight regions and events
- Zoom & Pan - Interactive exploration