PHPackages                             heybugio/heybugio - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging & Monitoring](/categories/logging)
4. /
5. heybugio/heybugio

ActiveLibrary[Logging & Monitoring](/categories/logging)

heybugio/heybugio
=================

HeyBug error tracking for Laravel

v1.0.3(3mo ago)06MITPHPPHP ^8.2CI passing

Since Feb 7Pushed 3mo agoCompare

[ Source](https://github.com/heybugio/heybugio)[ Packagist](https://packagist.org/packages/heybugio/heybugio)[ Docs](https://heybug.io)[ RSS](/packages/heybugio-heybugio/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (4)Used By (0)

 [![](https://camo.githubusercontent.com/283cf92d619efc9ed98fd36c87701f83c11dd2a2937d18cdccedfae55abf5526/68747470733a2f2f6865796275672e696f2f6c6f676f2e706e67)](https://heybug.io)

HeyBug
======

[](#heybug)

Laravel 12.x package for logging errors to [heybug.io](https://heybug.io)

[![Software License](https://camo.githubusercontent.com/03b042c7f27a761d40d3ba22ada11a64f5d0b3f87d09bded1a486d8c83602b09/68747470733a2f2f706f7365722e707567782e6f72672f686579627567696f2f686579627567696f2f6c6963656e73652e737667)](LICENSE.md)[![Latest Version on Packagist](https://camo.githubusercontent.com/ac4bc28231bc9cb08455e2fe365a2f5f1e8b750a5b00b6d0145ac63eb17fef25/68747470733a2f2f706f7365722e707567782e6f72672f686579627567696f2f686579627567696f2f762f737461626c652e737667)](https://packagist.org/packages/heybugio/heybugio)[![Total Downloads](https://camo.githubusercontent.com/c9910ee4078c2f3336df2b5b21bfb36128e9374f4e955569b63d5f06da51d553/68747470733a2f2f706f7365722e707567782e6f72672f686579627567696f2f686579627567696f2f642f746f74616c2e737667)](https://packagist.org/packages/heybugio/heybugio)

Version Support
---------------

[](#version-support)

PHPLaravel8.2+12.xInstallation
------------

[](#installation)

Install the package via composer:

```
composer require heybugio/heybugio
```

Publish the config file:

```
php artisan vendor:publish --provider="HeyBug\HeyBugServiceProvider"
```

Configuration
-------------

[](#configuration)

Add the following environment variables to your `.env`:

```
HEYBUG_API_KEY=your-api-key
HEYBUG_PROJECT_ID=your-project-id
```

Get your API key and project ID from [heybug.io](https://heybug.io) after creating a project.

Testing Your Configuration
--------------------------

[](#testing-your-configuration)

Verify your configuration is working:

```
php artisan heybug:test
```

Reporting Unhandled Exceptions
------------------------------

[](#reporting-unhandled-exceptions)

Add HeyBug as a log channel in `config/logging.php`:

```
'channels' => [
    'stack' => [
        'driver' => 'stack',
        'channels' => ['single', 'heybug'],
    ],

    'heybug' => [
        'driver' => 'heybug',
        'level' => 'error',
    ],
],
```

That's it! All unhandled exceptions will now be reported to HeyBug.

**Note:** By default, only production environments will report errors. You can adjust this in the `config/heybug.php` file.

Adding Context
--------------

[](#adding-context)

You can add custom context data to your error reports:

```
use HeyBug\Facades\HeyBug;

HeyBug::context([
    'order_id' => $order->id,
    'user_plan' => 'premium',
]);
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance81

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

99d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/13f75434292d72bfd764b2c0d69168adf19e7e273b64254e1be3372078359099?d=identicon)[aizuddinmanap](/maintainers/aizuddinmanap)

---

Top Contributors

[![aizuddinmanap](https://avatars.githubusercontent.com/u/358302?v=4)](https://github.com/aizuddinmanap "aizuddinmanap (4 commits)")

---

Tags

laravelmonitoringerror-reportingexceptionerror-trackingbug-trackingheybug

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/heybugio-heybugio/health.svg)

```
[![Health](https://phpackages.com/badges/heybugio-heybugio/health.svg)](https://phpackages.com/packages/heybugio-heybugio)
```

###  Alternatives

[kssadi/log-tracker

A powerful, intuitive, and efficient log viewer for Laravel applications.

264.8k](/packages/kssadi-log-tracker)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)