oopsydev/laravel
| Install | |
|---|---|
composer require oopsydev/laravel |
|
| Latest Version: | v0.5.1 |
| PHP: | ^8.2 |
| License: | MIT |
| Last Updated: | May 27, 2026 |
| Links: | GitHub · Packagist |
Installation
composer require oopsydev/laravel
Add your project key to .env:
OOPSY_KEY=your-project-key
That's it. The SDK auto-registers via Laravel's package discovery. No service provider registration, no config files, no middleware setup.
What It Captures
| Stack traces | Surrounding code context for every frame |
| Request context | HTTP method, URL, headers, body, query parameters |
| User context | Authenticated user ID, email, name |
| Environment | PHP version, Laravel version, server details |
| Breadcrumbs | Database queries, log entries, and HTTP requests leading up to the error |
How It Works
Exception occurs in your Laravel app
→ Oopsy SDK captures it via Laravel's exception handler
→ Builds payload with stack trace, context, and breadcrumbs
→ Sends HTTP POST to Oopsy API (async, non-blocking)
→ Your app continues normally — Oopsy never interferes
All error reporting is async via Http::async(). If the Oopsy API is unreachable, your app is completely unaffected.
JavaScript Error Tracking
Oopsy also captures client-side JavaScript errors. Add a single script tag to your HTML:
<script src="https://oopsy.dev/api/v1/js/YOUR_TOKEN.js" defer></script>
No npm package. No build step. Works with Blade, Livewire, Inertia, or any frontend.
Testing Your Setup
Verify your installation works:
php artisan oopsy:test
This sends a test exception to confirm connectivity.
AI / MCP Integration
Oopsy provides an MCP server that integrates with Claude Code, Cursor, and other MCP-compatible tools — allowing AI assistants to browse your errors and help debug them directly from your editor.
AI-friendly documentation is available at oopsy.dev/llms.txt.
Requirements
- PHP 8.2+
- Laravel 11, 12, or 13
Pricing
| Plan | Price | Errors/month | Projects |
|---|---|---|---|
| Free | $0 | 1,000 | 1 |
| Hobby | $5/mo | 50,000 | 5 |
| Pro | $19/mo | 500,000 | Unlimited |
Start free at oopsy.dev — no credit card required.
Comparisons
- Oopsy vs Sentry — purpose-built for Laravel vs generic platform
- Oopsy vs Flare — full-stack (PHP + JS) vs PHP-only
- Oopsy vs Nightwatch — error monitoring vs APM
Add the Badge
Show that your app is monitored by Oopsy:
[](https://oopsy.dev)
License
MIT
Related Packages
Kanbino Bug Tracking SDK for Laravel - Error capture, breadcrumbs, and session r...
A powerful, intuitive, and efficient log viewer for Laravel applications.
A powerful Laravel debugging tool with real-time monitoring, query debugging, an...