Server library
Realtime Laravel with WebSockets Laravel Broadcasting on the server and Laravel Echo in the browser, with no code changes.
Sign in to see these snippets with your own cluster host. Sign in
Using an AI coding agent? Copy the agent prompt ↓
Install composer require pusher/pusher-php-server
npm install --save-dev laravel-echo pusher-jsSet your app credentials BROADCAST_CONNECTION =pusher
PUSHER_APP_ID =YOUR_APP_ID
PUSHER_APP_KEY =YOUR_APP_KEY
PUSHER_APP_SECRET =YOUR_APP_SECRET
PUSHER_HOST =ws.hibira.io
PUSHER_PORT =443
PUSHER_SCHEME =https
PUSHER_APP_CLUSTER =ap
VITE_PUSHER_APP_KEY ="${PUSHER_APP_KEY}"
VITE_PUSHER_HOST ="${PUSHER_HOST}"
VITE_PUSHER_PORT ="${PUSHER_PORT}"
VITE_PUSHER_SCHEME ="${PUSHER_SCHEME}" Configure the client
import Echo from 'laravel-echo' ;
import Pusher from 'pusher-js' ;
window .Pusher = Pusher ;
window .Echo = new Echo ({
broadcaster : 'pusher' ,
key : import .meta .env .VITE_PUSHER_APP_KEY ,
cluster : 'ap' ,
wsHost : import .meta .env .VITE_PUSHER_HOST ,
wsPort : import .meta .env .VITE_PUSHER_PORT ,
wssPort : import .meta .env .VITE_PUSHER_PORT ,
forceTLS : import .meta .env .VITE_PUSHER_SCHEME === 'https' ,
enabledTransports : ['ws' , 'wss' ],
});
window .Echo .private ('orders.' + orderId)
.listen ('OrderShipped' , (e ) => console .log (e.order ));Publish an event
OrderShipped ::dispatch ($order );Agent prompt Paste this into Claude Code, Cursor, GitHub Copilot or another AI coding agent, and it will wire Hibira into your Laravel project with the settings above.
Integrate Hibira realtime messaging into this Laravel project. Hibira is a hosted WebSocket service that speaks the Pusher Channels protocol, so it works with the standard Pusher libraries (here: Broadcasting + Echo, https://laravel.com/docs/broadcasting) pointed at Hibira instead of pusher.com.
Connection details:
- Host: ws.hibira.io
- Port: 443
- TLS: yes (https)
- App ID: YOUR_APP_ID
- App key: YOUR_APP_KEY
- App secret: YOUR_APP_SECRET (server-side only)
What to do:
1. Look at the project first (framework version, package manager, config and env conventions, where similar integrations live) and follow what it already does.
2. If broadcasting isn't installed yet, run `php artisan install:broadcasting` and choose Pusher; otherwise switch the existing connection to pusher.
3. Make sure config/broadcasting.php passes host, port, scheme and useTLS from the PUSHER_* env values into the pusher connection's options, so nothing points at pusher.com.
4. Configure Laravel Echo in resources/js/echo.js (or bootstrap.js) like the reference below, using the VITE_PUSHER_* values.
5. Authorize private and presence channels in routes/channels.php.
6. Broadcast with events that implement ShouldBroadcast (they need a running queue worker) or ShouldBroadcastNow when the project has no queue.
7. Read the credentials and host from environment variables or the project's config, and add placeholder entries to .env.example (or its equivalent). Never commit real values, and never send the app secret to a browser or mobile app.
8. Always pass the host, port and TLS setting above. The library defaults to pusher.com; where it requires a cluster, use "ap" (the host decides where it connects).
9. If YOUR_APP_KEY or YOUR_APP_SECRET above is still a placeholder, keep it as an env placeholder and tell me where to fill it in rather than inventing a value.
10. When you are done, list the files you changed and tell me how to check it works, for example by publishing a test event and watching it arrive.
Reference setup from the Hibira Laravel guide (adapt it to the project's structure):
Install:
```shell
composer require pusher/pusher-php-server
npm install --save-dev laravel-echo pusher-js
```
Set your app credentials:
```ini
BROADCAST_CONNECTION=pusher
PUSHER_APP_ID=YOUR_APP_ID
PUSHER_APP_KEY=YOUR_APP_KEY
PUSHER_APP_SECRET=YOUR_APP_SECRET
PUSHER_HOST=ws.hibira.io
PUSHER_PORT=443
PUSHER_SCHEME=https
PUSHER_APP_CLUSTER=ap
VITE_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
VITE_PUSHER_HOST="${PUSHER_HOST}"
VITE_PUSHER_PORT="${PUSHER_PORT}"
VITE_PUSHER_SCHEME="${PUSHER_SCHEME}"
```
Configure the client:
```js
// resources/js/echo.js
import Echo from 'laravel-echo';
import Pusher from 'pusher-js';
window.Pusher = Pusher;
window.Echo = new Echo({
broadcaster: 'pusher',
key: import.meta.env.VITE_PUSHER_APP_KEY,
cluster: 'ap',
wsHost: import.meta.env.VITE_PUSHER_HOST,
wsPort: import.meta.env.VITE_PUSHER_PORT,
wssPort: import.meta.env.VITE_PUSHER_PORT,
forceTLS: import.meta.env.VITE_PUSHER_SCHEME === 'https',
enabledTransports: ['ws', 'wss'],
});
window.Echo.private('orders.' + orderId)
.listen('OrderShipped', (e) => console.log(e.order));
```
Publish an event:
```php
// Any event that implements ShouldBroadcast
OrderShipped::dispatch($order);
```
Replace YOUR_APP_KEY and the other placeholders with the values from your dashboard, or let the agent leave them as environment variables for you to fill in.
Or connect the Hibira MCP server, and your agent can create the app and fill in its credentials itself. Connect your AI coding agent →
Use the app key and secret from your dashboard. Channels, events and authorization endpoints work exactly as they do with Pusher. Library reference ↗
