@getvigilia/browser
v0.1.0
Published
Vigilia for the browser: errors, failed and slow requests, rage clicks and page speed from real visitors — explained in plain language, with a fix for your AI.
Maintainers
Readme
Vigilia for the browser
Know when your live app breaks, in plain language, with a fix your AI can apply. This is the browser SDK behind Vigilia: it catches errors, failed and slow requests, rage clicks and page speed from real visitors. Your dashboard turns them into incidents: what went wrong, who it affects, and a fix prompt for Lovable, Bolt, Cursor or Claude Code.
- Zero dependencies, under 10 KB, and it never throws into your app.
- Personal data is scrubbed in the browser before anything is sent: emails, tokens, card-like numbers and query strings.
Install
npm install @getvigilia/browserimport { init } from '@getvigilia/browser';
init({
key: 'vgl_…', // your app's public key
endpoint: 'https://…/v1/events', // shown on your app's install page
});Call init once, as early as you can (your entry file or root layout). It does
nothing on the server, so it is safe in server-rendered apps.
If your site sends a Content-Security-Policy, bundling the SDK means you only need
to allow the endpoint in connect-src. There's no script host to add.
Also
import { capture, breadcrumb } from '@getvigilia/browser';
try { risky(); } catch (err) { capture(err, 'saving the draft'); }
breadcrumb('opened the pricing dialog');Prefer a script tag? https://cdn.getvigilia.com/vigilia.js is the same SDK, and
it starts itself from its data-key attribute.
MIT licensed.
