PHPackages edulazaro/wirebug - 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. [Templating & Views](/categories/templating) 4. / 5. edulazaro/wirebug ActiveLibrary[Templating & Views](/categories/templating) edulazaro/wirebug ================= Drop-in floating bug/feedback report widget for Laravel apps. Themeable through the wire\* family CSS variables — shares look with wiremodal, wiretoast and wirecookies. 1.0.2(3w ago)14MITCSSPHP ^8.2 Since Jul 10Pushed 3w agoCompare [ Source](https://github.com/edulazaro/wirebug)[ Packagist](https://packagist.org/packages/edulazaro/wirebug)[ RSS](/packages/edulazaro-wirebug/feed)WikiDiscussions main Synced 1w ago READMEChangelog (3)Dependencies (4)Versions (4)Used By (0) [![Wirebug](art/banner.png)](art/banner.png) Wirebug ======= [](#wirebug) Drop-in floating bug/feedback report widget for Laravel apps. A small floating button opens a modal where the user picks a type (bug, suggestion, other) and writes a message. Reports are stored in your database with automatic technical context (URL, user agent, viewport, locale, authenticated user). Part of the `wire*` family: themeable through the shared `data-wire-theme` attribute, visually coherent with [wiremodal](https://github.com/edulazaro/wiremodal), [wiretoast](https://github.com/edulazaro/wiretoast) and [wirecookies](https://github.com/edulazaro/wirecookies). Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel 11+ - Alpine.js on the page Installation ------------ [](#installation) ``` composer require edulazaro/wirebug php artisan migrate ``` Import the CSS after wiremodal in your bundle: ``` @import '../../vendor/edulazaro/wiremodal/resources/css/wiremodal.css'; @import '../../vendor/edulazaro/wirebug/resources/css/wirebug.css'; ``` Usage ----- [](#usage) Drop the component in any layout (typically the logged-in app shell): ``` ``` Pick the theme once on `` (shared with the rest of the family): ``` ``` ### What the user writes [](#what-the-user-writes) - **Type**: bug / suggestion / other (configurable via `config('wirebug.types')`). - **Message**: free text, required, max 5000 chars. - **Steps to reproduce**: optional free text. - **Screenshot**: optional image attachment (jpg/png/gif/webp, 5MB max by default). - **Screen recording**: optional, via the browser's native `getDisplayMedia` + `MediaRecorder` (nothing records until the user clicks; zero background cost). While recording, the modal closes and a small in-app overlay shows a timer with Stop/Discard; on stop the modal reopens with the video attached (WebM/MP4, 90s / 50MB max by default, bitrate capped at 2 Mbps via `recording.bitrate`, `config('wirebug.recording')`). The button only appears on supporting browsers (desktop). The recording lives in the page's JS context: it survives SPA-style navigation (`wire:navigate`), a hard reload kills it. - **Email**: optional, only shown to guests (authenticated users are already identified). Disable with `'ask_guest_email' => false`. ### What is captured automatically [](#what-is-captured-automatically) URL, user agent, viewport, locale, the authenticated reporter (polymorphic `reporter_type`/`reporter_id`, morph-map aware) and referer. Disable with `'capture_context' => false`. ### Where everything is stored [](#where-everything-is-stored) Reports live in the `wirebug_reports` table of your app's database. The screenshot is stored through Laravel's `Storage` on the disk set in `config('wirebug.uploads.disk')` — any disk from your `config/filesystems.php` works the same (`local` server filesystem, `s3`, an S3-compatible R2 disk...). The report row keeps only the file path. ### Reading the reports [](#reading-the-reports) ``` use EduLazaro\WireBug\Models\BugReport; BugReport::new()->latest()->get(); // status = 'new' BugReport::ofType('bug')->get(); $report->reporter; // polymorphic: who sent it (User, Client... or null for guests) ``` ### Component props [](#component-props) ``` {{-- Edge tab instead of the floating button --}} ``` Every visible string can be overridden by prop or via the published translations. Two trigger styles: - `trigger="button"` (default): floating square button. `position` accepts `left` (default) or `right` (always bottom corner). - `trigger="tab"`: small labeled tab stuck flush to the screen edge. `position` accepts `bottom-right` (default), `bottom-left`, `top-right` or `top-left`. On viewports under 640px the label hides and only the icon shows. Label text via `tab-label` prop or the `tab_label` translation. ### Config [](#config) ``` php artisan vendor:publish --tag=wirebug-config ``` Route path/middleware (add `auth` if the widget only lives behind login), button position, report types, guest email, context capture and table name. ### Publishing assets [](#publishing-assets) ``` php artisan vendor:publish --tag=wirebug-views php artisan vendor:publish --tag=wirebug-css php artisan vendor:publish --tag=wirebug-lang php artisan vendor:publish --tag=wirebug-migrations ``` Events ------ [](#events) - `wirebug-sent` is dispatched on `window` after a successful submit, in case the host app wants to toast or track it. Sponsors -------- [](#sponsors) Wirebug is supported by the following sponsors. Thank you for keeping it growing: [![Kenodo](art/logo-kenodo.png)](https://kenodo.com) [Kenodo](https://kenodo.com) [![AndorraDev](art/logo-andorradev.png)](https://andorradev.com) [AndorraDev](https://andorradev.com) Author ------ [](#author) Created by [Edu Lazaro](https://edulazaro.com) License ------- [](#license) Wirebug is open-sourced software licensed under the [MIT license](LICENSE.md). ### Health Score 40 — FairBetter than 86% of packages Maintenance94 Actively maintained with recent releases Popularity5 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 ~11 days Total 3 Last Release 27d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/6a3c47449dfb2ec121aa410da024f47586b87cc2799a825f0418e6c5e5904955?d=identicon)[edulazaro](/maintainers/edulazaro) --- Top Contributors [![edulazaro](https://avatars.githubusercontent.com/u/7797530?v=4)](https://github.com/edulazaro "edulazaro (14 commits)") --- Tags laravelbladereportwidgetfeedbackalpinebug ### Embed Badge ![Health badge](/badges/edulazaro-wirebug/health.svg) ``` [![Health](https://phpackages.com/badges/edulazaro-wirebug/health.svg)](https://phpackages.com/packages/edulazaro-wirebug) ``` ### Alternatives [moonshine/moonshine Laravel administration panel 1.3k268.2k90](/packages/moonshine-moonshine)[hasinhayder/tyro-dashboard Tyro Dashboard - Beautiful admin dashboard for managing Tyro roles, privileges, users, and settings 5495.1k](/packages/hasinhayder-tyro-dashboard)[technikermathe/blade-lucide-icons A package to easily make use of Lucide icons in your Laravel Blade views. 18473.9k13](/packages/technikermathe-blade-lucide-icons)[hasinhayder/tyro-login Tyro Login - Beautiful, customizable authentication views for Laravel 12 & 13 2508.1k7](/packages/hasinhayder-tyro-login)[ublabs/blade-simple-icons A package to easily make use of Simple Icons in your Laravel Blade views. 1866.3k](/packages/ublabs-blade-simple-icons) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)