PHPackages cerealkiller97/filament-bug-reports - 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. cerealkiller97/filament-bug-reports ActiveLibrary cerealkiller97/filament-bug-reports =================================== A Filament plugin to collect in-app bug reports and push validated ones to GitHub issues. v1.0.0(1mo ago)8150↑775%1[6 issues](https://github.com/CerealKiller97/filament-bug-reports/issues)[1 PRs](https://github.com/CerealKiller97/filament-bug-reports/pulls)Apache-2.0PHPPHP ^8.3CI passing Since Jul 16Pushed 2w agoCompare [ Source](https://github.com/CerealKiller97/filament-bug-reports)[ Packagist](https://packagist.org/packages/cerealkiller97/filament-bug-reports)[ RSS](/packages/cerealkiller97-filament-bug-reports/feed)WikiDiscussions main Synced 1w ago READMEChangelog (1)Dependencies (11)Versions (3)Used By (0) [![Filament Bug Reports β€” in-app bug reports, triaged in your panel and pushed to GitHub as issues](art/og.png)](art/og.png) Filament Bug Reports ==================== [](#filament-bug-reports) [![Packagist](https://camo.githubusercontent.com/fba1b7cf870587427f2afae1646e094723aa1568b77d4422635f61d09c43ba28/68747470733a2f2f736869656c64636e2e6465762f62616467652f7061636b61676973742d76312e312e302d3235363365622e7376673f6c6f676f3d7061636b6167697374266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/cerealkiller97/filament-bug-reports)[![Release](https://camo.githubusercontent.com/a2bc751667af8924c7afbcec3ebcf5061ee3db3740d717904b1df751bebea275/68747470733a2f2f736869656c64636e2e6465762f6769746875622f43657265616c4b696c6c657239372f66696c616d656e742d6275672d7265706f7274732f72656c656173652e737667)](https://github.com/CerealKiller97/filament-bug-reports/releases)[![Tests](https://camo.githubusercontent.com/38bdf31739d862ea7fa21ec1bd6c32b8a8711374de4e87e532b1d1a52cc33b8b/68747470733a2f2f736869656c64636e2e6465762f6769746875622f43657265616c4b696c6c657239372f66696c616d656e742d6275672d7265706f7274732f63692e7376673f776f726b666c6f773d74657374732e796d6c266c6162656c3d7465737473)](https://github.com/CerealKiller97/filament-bug-reports/actions/workflows/tests.yml)[![PHPStan](https://camo.githubusercontent.com/1b82994b37447e1674b58afba5d7d36a2bcdbe323b59bdbd107009ca40c7dfcf/68747470733a2f2f736869656c64636e2e6465762f6769746875622f43657265616c4b696c6c657239372f66696c616d656e742d6275672d7265706f7274732f63692e7376673f776f726b666c6f773d7068707374616e2e796d6c266c6162656c3d7068707374616e)](https://github.com/CerealKiller97/filament-bug-reports/actions/workflows/phpstan.yml)[![Type coverage](https://camo.githubusercontent.com/8866533d614019aa95c9a709f2e988bda2563ebdb256545b23387c8a9125fc47/68747470733a2f2f736869656c64636e2e6465762f6769746875622f43657265616c4b696c6c657239372f66696c616d656e742d6275672d7265706f7274732f63692e7376673f776f726b666c6f773d747970652d636f7665726167652e796d6c266c6162656c3d7479706573)](https://github.com/CerealKiller97/filament-bug-reports/actions/workflows/type-coverage.yml)[![License](https://camo.githubusercontent.com/66372abfb22d5dc4284f50732365de51babbff573360014c53ba7fa766d350c3/68747470733a2f2f736869656c64636e2e6465762f6769746875622f43657265616c4b696c6c657239372f66696c616d656e742d6275672d7265706f7274732f6c6963656e73652e737667)](LICENSE.md) Get instant feedback from the people actually using your app. Collect bug reports from inside your Filament panel, and push the ones you confirm are real straight to GitHub as issues. Feedback arrives the moment a user hits the problem β€” not days later through a support email, a Slack thread, or a screenshot with no context. Your users get a **Report a bug** button in the panel's topbar and a short, plain-language form β€” no Markdown, no issue templates, no GitHub account. You get a triage table where a single click turns a report into a proper GitHub issue, and the issue's state (open/closed) is mirrored back onto the report automatically. **πŸ“– [Read the documentation](https://filament-bug-reports.stefanbogdanovic.dev/)** DarkLight[![Triage table in dark mode](art/triage-table-dark.png)](art/triage-table-dark.png)[![Triage table in light mode](art/triage-table-light.png)](art/triage-table-light.png)How it works ------------ [](#how-it-works) 1. **Anyone in the panel reports a bug.** They describe the problem, list the steps that led to it, and optionally attach a screenshot. The report is stamped with the reporter, their role and the running app version β€” they aren't asked for any of it. 2. **A manager triages.** Reports land in a table only managers can see. Noise gets deleted; the real ones get **Mark as real**. 3. **A GitHub issue is created**, with the steps and screenshot formatted into the body. The issue number and URL are stored on the report. 4. **State syncs back.** An hourly command checks each linked issue: closed becomes *Resolved*, reopened flips back to *In progress*. Requirements ------------ [](#requirements) - PHP 8.3+ - Laravel 13.x - Filament 5.x Installation ------------ [](#installation) ``` composer require cerealkiller97/filament-bug-reports ``` Publish and run the migration: ``` php artisan vendor:publish --tag=bug-reports-migrations php artisan migrate ``` Optionally publish the config file: ``` php artisan vendor:publish --tag=bug-reports-config ``` Then register the plugin on the panel you want it in: ``` use CerealKiller97\FilamentBugReports\BugReportsPlugin; public function panel(Panel $panel): Panel { return $panel // ... ->plugin( BugReportsPlugin::make() ->authorizeManagementUsing(fn (User $user): bool => $user->isAdmin()), ); } ``` That single `authorizeManagementUsing` call matters: **management defaults to nobody**. Until you opt someone in, no one can see the report list β€” though everyone can still file a report. Finally, point it at a repository with a token that has the `repo` (or `issues:write`) scope: ``` BUG_REPORTS_GITHUB_TOKEN=ghp_xxxxxxxxxxxx BUG_REPORTS_GITHUB_REPOSITORY=acme/platform ``` See the [installation guide](https://filament-bug-reports.stefanbogdanovic.dev/docs/installation) for the rest. Documentation ------------- [](#documentation) [Authorization](https://filament-bug-reports.stefanbogdanovic.dev/docs/authorization)Who can file a report, and who can triage one.[Reporting a bug](https://filament-bug-reports.stefanbogdanovic.dev/docs/reporting)The topbar button and the form behind it.[The triage table](https://filament-bug-reports.stefanbogdanovic.dev/docs/triage)The stats, the grouping, and marking a report as real.[The GitHub issue](https://filament-bug-reports.stefanbogdanovic.dev/docs/github-issues)What the created issue looks like, and which options GitHub honours.[Keeping reports in sync](https://filament-bug-reports.stefanbogdanovic.dev/docs/sync)Mirroring issue state back onto the report.[Configuration](https://filament-bug-reports.stefanbogdanovic.dev/docs/configuration)Every key in `config/bug-reports.php`.[Translations](https://filament-bug-reports.stefanbogdanovic.dev/docs/translations)Changing the wording.Testing ------- [](#testing) ``` composer test # Pest composer lint # Pint composer analyse # PHPStan composer type-coverage # Pest type coverage (must stay at 100%) ``` Contributing ------------ [](#contributing) Pull requests are welcome β€” bug fixes, new features, better docs, or just a typo you spotted. See the [contributing guide](https://filament-bug-reports.stefanbogdanovic.dev/docs/contributing) for the workflow, and open the PR even if you're unsure about it. License ------- [](#license) Apache License 2.0. See [LICENSE.md](LICENSE.md). --- Proudly made by [Stefan Bogdanovic](https://stefanbogdanovic.dev). ### Health Score 43 β€” FairBetter than 89% of packages Maintenance79 Regular maintenance activity Popularity22 Limited adoption so far Community10 Small or concentrated contributor base Maturity50 Maturing project, gaining track record Bus Factor1 Top contributor holds 78.4% 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 Unknown Total 1 Last Release 46d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/22789589?v=4)[Stefan BogdanoviΔ‡](/maintainers/CerealKiller97)[@CerealKiller97](https://github.com/CerealKiller97) --- Top Contributors [![CerealKiller97](https://avatars.githubusercontent.com/u/22789589?v=4)](https://github.com/CerealKiller97 "CerealKiller97 (69 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (13 commits)")[![Aug-Zhn](https://avatars.githubusercontent.com/u/123251148?v=4)](https://github.com/Aug-Zhn "Aug-Zhn (6 commits)") --- Tags bug-reportingfilamentphplaravelpluginpluginlaravelgithubfilamentissuesbug-reports ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/cerealkiller97-filament-bug-reports/health.svg) ``` [![Health](https://phpackages.com/badges/cerealkiller97-filament-bug-reports/health.svg)](https://phpackages.com/packages/cerealkiller97-filament-bug-reports) ``` ### Alternatives [rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3915.5k](/packages/rawilk-profile-filament-plugin)[awcodes/filament-curator A media picker plugin for FilamentPHP. 441414.6k29](/packages/awcodes-filament-curator)[codewithdennis/filament-select-tree The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths. 331634.0k37](/packages/codewithdennis-filament-select-tree)[finity-labs/fin-mail A powerful email template manager and composer for Filament with dynamic token replacement, template versioning, and inline email sending. 316.8k2](/packages/finity-labs-fin-mail)[stephenjude/filament-jetstream A Laravel starter kit built with Filament inspired by Jetstream. 17863.7k3](/packages/stephenjude-filament-jetstream)[tapp/filament-maillog Filament plugin to view outgoing mail 3084.0k1](/packages/tapp-filament-maillog) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)