# DonutChart
Animated donut chart with center text for showing proportions
## Overview
The `DonutChart` 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**
- List of objects with label, value, and optional color
### `title`
- Type: `string`
- *Optional* (default: ``)
- Optional chart title
### `center_text`
- Type: `string`
- *Optional* (default: ``)
- Text to display in center
### `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_donutchart(
data=[
{
"label": "Complete",
"value": 75
},
{
"label": "In Progress",
"value": 15
}
],
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*