> Source: https://laravilt.com/docs/widgets/introduction

# Widgets

Dashboard widgets for displaying metrics and charts.

## Installation

```bash
composer require laravilt/widgets
```

## Documentation

- [Stats Overview](https://github.com/laravilt/laravilt/blob/HEAD/docs/widgets/types/stats-overview) - Statistics grid
- [Line Chart](https://github.com/laravilt/laravilt/blob/HEAD/docs/widgets/types/line-chart) - Trend charts
- [Bar Chart](https://github.com/laravilt/laravilt/blob/HEAD/docs/widgets/types/bar-chart) - Bar charts
- [Pie Chart](https://github.com/laravilt/laravilt/blob/HEAD/docs/widgets/types/pie-chart) - Pie/doughnut charts
- [Custom Widgets](https://github.com/laravilt/laravilt/blob/HEAD/docs/widgets/custom-widgets) - Create widgets

## Quick Example

```php
<?php

use Laravilt\Widgets\StatsOverviewWidget;
use Laravilt\Widgets\Stat;

StatsOverviewWidget::make()
    ->heading('Overview')
    ->columns(3)
    ->stats([
        Stat::make('Users', fn () => User::count())
            ->icon('Users')
            ->color('primary'),
        Stat::make('Revenue', '$12,345')
            ->description('+12%')
            ->color('success'),
    ])
    ->polling(30);
```

## Widget Base Class

| Method | Description |
|--------|-------------|
| `make()` | Create instance |
| `heading(string)` | Widget title |
| `description(string)` | Description text |
| `icon(string)` | Widget icon |
| `color(string)` | Theme color |
| `polling(?int)` | Auto-refresh interval |

## Colors

```php
<?php

->color('primary')  // Blue
->color('success')  // Green
->color('danger')   // Red
->color('warning')  // Yellow
->color('info')     // Sky
```

## Related

- [Stat Component](https://github.com/laravilt/laravilt/blob/HEAD/docs/widgets/stat) - Individual stats
- [Panel](https://github.com/laravilt/laravilt/blob/HEAD/docs/panel/introduction) - Dashboard integration