cloudbay/friendly-errors

Friendly, guided 500 pages with incident IDs and human context for Laravel apps.

Maintainers

Details

github.com/cloudbaysc/friendly-errors

Source

Issues

Installs: 2

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

pkg:composer/cloudbay/friendly-errors

v1.0.0 2025-10-06 06:18 UTC

Requires

MIT 263848b7b852796005db9990adb4ec6172756ed7

This package is auto-updated.

Last update: 2026-01-06 06:56:15 UTC

README

A Laravel package that replaces ugly 500 error pages with friendly, non-technical error screens.
It shows a unique incident ID (logged + displayed), optional business context (like the item and submitter), and clear next steps for users (support contacts, retry/back buttons).

Works out of the box for both web and API responses.
Perfect for any Laravel project.

🚀 Features

  • Generates a unique incident ID for every request (logged + shown).
  • Friendly 500 page with human wording (not a stack trace).
  • Configurable support contacts: email, phone, WhatsApp, docs link, business hours.
  • Optional context resolver: shows what item/request caused the error and who submitted it.
  • Works for web and API (returns JSON if Accept: application/json).
  • Easily customizable views and config.
  • Zero app Handler.php overrides (safe middleware-based).
  • PSR-4 autoloaded + Laravel auto-discovery.

📦 Installation

Require the package via Composer:

composer require cloudbay/friendly-errors