Migration Guide

Learn how to migrate from other charting libraries to React ECharts Kit and upgrade between versions.

Migrating from Chart.js

If you're coming from Chart.js, here's how to convert your existing charts.

Before (Chart.js)

tsx

After (React ECharts Kit)

tsx

Migrating from Recharts

Converting from Recharts is straightforward with similar data structures.

Before (Recharts)

tsx

After (React ECharts Kit)

tsx

Version Upgrades

Guide for upgrading between major versions of React ECharts Kit.

v1.x to v2.x

Breaking Changes:

  • Theme prop renamed from theme to chartTheme
  • Default export changed to named exports
  • Responsive prop now defaults to true

Migration Steps:

tsx

Migration Checklist

  • Update package.json dependencies
  • Convert data format to React ECharts Kit structure
  • Update import statements
  • Migrate configuration options
  • Test responsive behavior
  • Verify theme compatibility
  • Update event handlers
  • Run comprehensive tests