fengmk2/ohbug

Ohbug is a monitoring tool that automatically catches errors and problems in JavaScript web applications. When something breaks in your code, whether it's an uncaught error, a failed API call, or a missing resource, Ohbug captures it and sends the details to a server so your team can see what went wrong and fix it quickly. Think of it like a safety net for your website. Instead of users silently closing the tab when something breaks, Ohbug records what happened: what error occurred, what the user was doing before it broke, what browser they were using, and more. You can then log into a dashboard (a separate self-hosted application) to review these incidents, see how often they happen, and trace them back to the code that caused them. The tool works by installing a small JavaScript package into your web application. It monitors for various failure types, JavaScript errors, network request failures, unhandled promise rejections, and WebSocket errors, then packages up the event details and reports them to your backend. You can customize what gets tracked, add user information, attach extra metadata, and even extend it with plugins to capture additional data like session replays (video-like recordings of what the user was doing). Ohbug is built with developers in mind. If you're using React, Vue, or Angular, the README shows how to integrate it in just a few lines of code. The package is designed to be lightweight and tree-shakable, meaning it won't bloat your application bundle. You can add hooks to inspect or modify events before they're sent, track specific user actions, and configure where the data gets reported, defaulting to a self-hosted server running on your own infrastructure. The project includes not just the monitoring client but also integrations for different frameworks, TypeScript types, build plugins for uploading source maps (which help show you the exact line of code that failed), and a separate self-hosted dashboard application where you can view and manage all the errors your application is reporting.