# Your Hibira usage on the Laravel Pulse dashboard

> A Pulse card that shows connections, messages and data sent next to your plan’s limits, a chart that follows Pulse’s period picker, and the busiest channels right now.

Source: https://hibira.io/guides/pulse

A Pulse card that shows connections, messages and data sent next to your plan’s limits, a chart that follows Pulse’s period picker, and the busiest channels right now.

Package: hibira-io/pulse

- Connections now and the period’s peak against your plan’s limit, and today’s messages against the daily limit, so you see a limit coming before your users do.
- The busiest channels by subscriber count, read from the Channels HTTP API with your app key and secret.
- Nothing is recorded into Pulse’s tables: each reading comes from Hibira and is cached for 60 seconds.

## 1. Install

```shell
composer require hibira-io/pulse
```

## 2. Set it up

```ini
# A personal API token with read access, from https://hibira.io/portal/api-tokens
HIBIRA_API_TOKEN=hkb_pat_...
HIBIRA_APP_ID=YOUR_APP_ID
# Optional: the key and secret turn on the channel list
HIBIRA_APP_KEY=YOUR_APP_KEY
HIBIRA_APP_SECRET=YOUR_APP_SECRET
```

## 3. Use it

```html
{{-- resources/views/vendor/pulse/dashboard.blade.php --}}
<x-pulse>
    <livewire:hibira.usage cols="6" rows="2" />
    ...
</x-pulse>
```

## Before you start

- Restrict the API token to this one app and give it read access only: the card never changes anything.
- Run php artisan vendor:publish --tag=pulse-dashboard first if your app has no Pulse dashboard view yet.

- [Packagist](https://packagist.org/packages/hibira-io/pulse)
- [GitHub](https://github.com/hibira-io/pulse)