echarts-for-react is a React wrapper component for Apache ECharts, designed to simplify the integration of ECharts visualization capabilities into React applications. The repository is written in TypeScript and serves as a bridge between the powerful ECharts library and React's component-based architecture. According to the README, it positions itself as the simplest and best React wrapper available for Apache ECharts, with support for visualization through the MCP Server mcp-server-chart.
The component accepts a comprehensive set of props that control chart behavior and appearance. The required option prop contains the ECharts configuration object that defines what the chart displays. Optional props include notMerge and replaceMerge for controlling how data updates are applied, lazyUpdate for deferred rendering, and style and className for customizing the chart container's appearance. The theme prop allows users to apply custom ECharts themes after registration. Additional props like showLoading and loadingOption enable loading state visualization, while onChartReady provides a callback when the chart finishes initializing. The onEvents prop allows binding to ECharts events with custom callbacks. The opts prop passes initialization options directly to echarts.init, and autoResize controls whether the chart automatically resizes when the window changes.
The component exposes a single primary API method, getEchartsInstance, which returns the underlying ECharts instance object.
The repository demonstrates flexibility in supporting multiple ECharts versions. For ECharts v5 and v6, users can manually import specific modules to reduce bundle size. For earlier versions like v3 and v4, different import patterns are supported. The documentation includes specific guidance for Next.js users, noting that transpilation is needed and providing configuration examples for both Next.js 13.1 and higher versions using the transpilePackages option, as well as instructions for earlier versions using next-transpile-modules.
The repository is classified across numerous data visualization and charting categories, reflecting its broad applicability in dashboard components, interactive graphs, and business intelligence tools.
