# React ECharts Library

> Modern React wrapper for Apache ECharts with TypeScript support

React ECharts Library provides a simple, declarative way to use Apache ECharts in React applications. It supports all ECharts chart types, themes, events, and tree-shaking for optimized bundles.

## Quick Links

- Homepage: /
- GitHub: https://github.com/yerzhansa/react-echarts-library
- npm: https://www.npmjs.com/package/react-echarts-library
- Full Documentation: /llms-full.txt

## Getting Started

- [Installation](/docs/getting-started/installation): How to install react-echarts-library
- [Quick Start](/docs/getting-started/quick-start): Create your first chart in 5 minutes

## API Reference

- [EChartsReact API](/docs/api/echarts-react): Full component API reference
- [EChartsCore API](/docs/api/echarts-core): Tree-shakeable component for smaller bundles
- [Props Reference](/docs/api/props): Complete props table with types

## Guides

- [Events Guide](/docs/guides/events): Event handling patterns
- [Themes Guide](/docs/guides/themes): Built-in and custom themes
- [Tree Shaking](/docs/guides/tree-shaking): Bundle size optimization

## Examples

- [Chart Examples](/examples): Line, Bar, Pie, Radar, Gauge, Scatter, and more

## Installation

```bash
npm install react-echarts-library echarts
```

## Basic Usage

```tsx
import { EChartsReact } from 'react-echarts-library';

function MyChart() {
  const option = {
    xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed'] },
    yAxis: { type: 'value' },
    series: [{ type: 'bar', data: [120, 200, 150] }]
  };

  return <EChartsReact option={option} style={{ height: 400 }} />;
}
```

## Key Features

- **Easy to Use**: Simple, declarative React API
- **Tree Shakeable**: Import only what you need with EChartsCore
- **TypeScript**: Full type definitions included
- **All Chart Types**: 50+ chart types from Apache ECharts
- **Responsive**: Auto-resize on container changes
- **Events**: Full event handling support
- **Themes**: Built-in and custom themes