# AreaChart
Animated area chart showing trends with filled gradient
## Overview
The `AreaChart` component is a chart component in the chuk-motion library.
## Animations
### `draw`
Chart draws with animation
### `fade_in`
Chart fades in
### `scale_in`
Chart scales from center
## Properties
### `data`
- Type: `array`
- **Required**
- Array of data points as [x, y] or {x, y, label}
### `title`
- Type: `string`
- *Optional* (default: ``)
- Optional chart title
### `xlabel`
- Type: `string`
- *Optional* (default: ``)
- Optional x-axis label
### `ylabel`
- Type: `string`
- *Optional* (default: ``)
- Optional y-axis label
### `start_time`
- Type: `float`
- **Required**
- When to show (seconds)
### `duration`
- Type: `float`
- **Required**
- How long to animate (seconds)
## Example Usage
### Python (MCP Tool)
```python
remotion_add_areachart(
data=[
[
0,
10
],
[
1,
25
],
[
2,
45
]
],
title="Example Chart",
duration=4.0
)
```
### TSX (Generated)
The component generates TypeScript/React code that integrates with Remotion.
## Design Tokens
This component uses the chuk-motion design token system for consistent styling:
- **Colors**: Theme-aware color palettes
- **Typography**: Video-optimized font scales
- **Motion**: Spring physics and easing curves
- **Spacing**: Consistent spacing and safe margins
## Tips & Best Practices
- Keep data concise for readability on video
- Use contrasting colors for better visibility
- Consider animation duration based on data complexity
- Test at your target resolution (1080p, 4K)
## Related Components
Browse other chart components in the [component library](../../../README.md).
---
*Generated documentation for chuk-motion component library*