PHPackages makararoth/filament-react-error-pages - 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. [Utility & Helpers](/categories/utility) 4. / 5. makararoth/filament-react-error-pages ActiveLibrary[Utility & Helpers](/categories/utility) makararoth/filament-react-error-pages ===================================== A Laravel package that provides React-based custom error pages with Filament support v0.1.7(11mo ago)07MITTypeScriptPHP ^8.1CI failing Since May 20Pushed 11mo ago1 watchersCompare [ Source](https://github.com/ch-Makara-roth/filament-react-error-pages)[ Packagist](https://packagist.org/packages/makararoth/filament-react-error-pages)[ RSS](/packages/makararoth-filament-react-error-pages/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (4)Versions (9)Used By (0) Filament React Error Pages ========================== [](#filament-react-error-pages) A Laravel package that provides React-based custom error pages with Filament admin panel integration. [![Latest Version on Packagist](https://camo.githubusercontent.com/6f6d6db9d748f07c9a817631f61d208fbed89f701dd5f05e9c301c612e3e13ad/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f63682d6d616b6172612d726f74682f66696c616d656e742d72656163742d6572726f722d70616765732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ch-makara-roth/filament-react-error-pages)[![GitHub Tests Action Status](https://camo.githubusercontent.com/0b38999165671f82613c8e6d0b6af25e500543256012dfe79c3481dc5e70b4ea/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f63682d6d616b6172612d726f74682f66696c616d656e742d72656163742d6572726f722d70616765732f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/ch-makara-roth/filament-react-error-pages/actions?query=workflow%3Arun-tests+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/24b8dadaf9bed46bb73a2a87f75f12c8308bf1935c2c869c59b6c78a3640b113/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f63682d6d616b6172612d726f74682f66696c616d656e742d72656163742d6572726f722d70616765732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ch-makara-roth/filament-react-error-pages)[![License](https://camo.githubusercontent.com/02ed3dae55963a7c3b0ca0e83f71605ae3c2e4c7aa122fa638eeabd014c381a4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f63682d6d616b6172612d726f74682f66696c616d656e742d72656163742d6572726f722d70616765733f7374796c653d666c61742d737175617265)](LICENSE.md) Features -------- [](#features) - Custom React-powered error pages for your Laravel application - Seamless integration with Filament admin panel - TypeScript support for better development experience - Customizable styles and configurations - Easy to extend with your own error components Screenshots ----------- [](#screenshots) *Coming soon* Installation ------------ [](#installation) ### Prerequisites [](#prerequisites) - PHP 8.1 or higher - Laravel 10.0 or higher - Filament 3.0 or higher (for Filament integration) - Node.js and npm/yarn (for building React components) ### Via Composer [](#via-composer) ``` composer require ch-makara-roth/filament-react-error-pages ``` ### Publish Assets and Config [](#publish-assets-and-config) ``` php artisan vendor:publish --tag=filament-react-error-pages-config php artisan vendor:publish --tag=filament-react-error-pages-assets ``` ### Troubleshooting Installation [](#troubleshooting-installation) If you encounter an error during the `artisan filament:upgrade` command after installation that indicates missing asset files, please ensure you're using the latest version of the package: ``` composer require makararoth/filament-react-error-pages:^0.1.5 ``` The error might look like: ``` ErrorException: copy(...): Failed to open stream: No such file or directory ``` This issue was fixed in version 0.1.5 by ensuring the required asset files are properly published and available in the correct location. If you're still experiencing issues after upgrading, you may need to manually publish the assets: ``` php artisan vendor:publish --tag=filament-react-error-pages-assets --force ``` This will ensure the CSS and JavaScript files are properly published to your application. Configuration ------------- [](#configuration) After publishing the configuration file, you can customize the error pages in the `config/filament-react-error-pages.php` file: ``` // Enable or disable custom error pages 'use_custom_error_pages' => true, // Enable or disable Filament integration 'use_in_filament' => true, // Customize styles and appearance 'styles' => [ 'theme' => 'system', 'colors' => [ 'primary' => '#3b82f6', // ... ], // ... ], // Global props for all error components 'global_props' => [ 'back_button_text' => 'Go Back', 'home_button_text' => 'Go to Homepage', // ... ], // Custom components for specific error codes 'error_components' => [ 404 => 'CustomNotFoundPage', 500 => 'CustomServerErrorPage', ], ``` Usage ----- [](#usage) ### Basic Usage [](#basic-usage) Once installed and configured, the package will automatically replace Laravel's default error pages with React-powered custom error pages. ### Custom Error Pages [](#custom-error-pages) You can create your own custom error components by: 1. Creating React components in your application 2. Registering them in the configuration: ``` 'error_components' => [ 404 => 'MyCustomNotFoundPage', 500 => 'MyCustomServerErrorPage', ], ``` ### Usage in Blade Templates [](#usage-in-blade-templates) You can render error pages manually in your Blade templates: ``` {!! app('filament-react-error-pages')->render(404, [ 'message' => 'The page you were looking for could not be found.', 'companyName' => config('app.name'), 'supportEmail' => 'support@example.com', ]) !!} ``` ### Filament Integration [](#filament-integration) When Filament integration is enabled, the package will provide custom error pages within the Filament admin panel. Example usage: ``` // In a Filament page or resource public function render() { try { // Your code that might throw an exception } catch (\Exception $e) { return view('filament-react-error-pages::examples.filament-integration', [ 'errorCode' => 500, 'message' => 'An error occurred while processing your request.', ]); } return parent::render(); } ``` Customization ------------- [](#customization) ### Styling the Error Pages [](#styling-the-error-pages) You can customize the appearance of error pages by: 1. Modifying the config file 2. Creating custom React components 3. Publishing and editing the views ### Supported Error Codes [](#supported-error-codes) - 400 (Bad Request) - 401 (Unauthorized) - 403 (Forbidden) - 404 (Not Found) - 419 (Page Expired) - 429 (Too Many Requests) - 500 (Server Error) - 503 (Service Unavailable) Testing ------- [](#testing) ``` composer test npm test ``` Changelog --------- [](#changelog) Please see [CHANGELOG.md](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Contributions are welcome! Please feel free to submit a Pull Request. For Maintainers --------------- [](#for-maintainers) ### Releasing a New Version [](#releasing-a-new-version) When releasing a new version of this package, follow these steps to ensure assets are properly included: 1. Make your changes to the codebase 2. Run the build process to generate assets: ``` npm run build ``` 3. Check that the following files exist and have content: - `dist/js/app.js` - `dist/css/app.css` - `public/js/app.js` - `public/css/app.css` 4. Update the version number in `package.json` 5. Update the `CHANGELOG.md` with details of the changes 6. Commit all changes, including the built assets in the `dist` directory 7. Tag the release with the new version number 8. Push to the repository with tags: ``` git push --tags ``` 9. The package will automatically update on Packagist **Important**: Do not ignore the `/dist` directory in `.gitignore`. The built assets must be included in the repository for the package to work correctly when installed via Composer. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) If you discover a security vulnerability, please send an e-mail to Makara Roth via . All security vulnerabilities will be promptly addressed. Credits ------- [](#credits) - [Makara Roth](https://github.com/ch-makara-roth) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 28 — LowBetter than 54% of packages Maintenance53 Moderate activity, may be stable Popularity4 Limited adoption so far Community7 Small or concentrated contributor base Maturity40 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 8 Last Release 354d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/45ee504c3a9f6c17d33acec26a43a410d6a7771883cfccd7ac0c112d207fdbce?d=identicon)[ch-Makara-roth](/maintainers/ch-Makara-roth) --- Top Contributors [![ch-Makara-roth](https://avatars.githubusercontent.com/u/165638148?v=4)](https://github.com/ch-Makara-roth "ch-Makara-roth (10 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/makararoth-filament-react-error-pages/health.svg) ``` [![Health](https://phpackages.com/badges/makararoth-filament-react-error-pages/health.svg)](https://phpackages.com/packages/makararoth-filament-react-error-pages) ``` ### Alternatives [illuminate/pipeline The Illuminate Pipeline package. 9446.6M210](/packages/illuminate-pipeline)[bezhansalleh/filament-google-analytics Google Analytics integration for FilamentPHP 205144.8k5](/packages/bezhansalleh-filament-google-analytics)[kirschbaum-development/commentions A package to allow you to create comments, tag users and more 12369.2k](/packages/kirschbaum-development-commentions)[hydrat/filament-table-layout-toggle Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts. 6292.3k1](/packages/hydrat-filament-table-layout-toggle)[interaction-design-foundation/laravel-geoip Support for multiple Geographical Location services. 17221.0k3](/packages/interaction-design-foundation-laravel-geoip)[eduardoribeirodev/filament-leaflet Um widget de mapa para FilamentPHP. 134.6k](/packages/eduardoribeirodev-filament-leaflet) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)