Getting Started

VibePing is analytics and error tracking for vibe-coded apps. One script tag gives you pageviews, errors, Web Vitals, and session tracking — no config, no SDK gymnastics.

Built for apps shipped with Lovable, Bolt.new, Cursor, Replit, and plain React/Next.js.

30-Second Quickstart

1. Get your API key — sign up at app.vibeping.dev↗ and create a project. Copy the API key (starts with vp_).

2. Add the script tag — paste this into your HTML <head>:

<script
  src="https://cdn.jsdelivr.net/npm/@vibeping/sdk@latest/dist/vibeping.umd.js"
  data-id="vp_your_api_key"
></script>

3. That's it. Open your app, then check your dashboard↗. You'll see:

Pageviews in real-time
Errors auto-captured with stack traces
Web Vitals (LCP, CLS, INP, TTFB)
Sessions tracked automatically

No npm install. No build step. No config files. Under 5KB.

What Gets Tracked Automatically

The SDK captures these events out of the box:

Event	What it does
`pageview`	Fires on every page navigation (including SPA route changes)
`error`	Catches `window.onerror` and `unhandledrejection`
`vital`	Measures LCP, CLS, INP, TTFB
`session`	Tracks session start/end with duration

You can also send custom events with track() and associate user data with identify(). See the SDK Reference.

Next Steps

Installation — CDN vs npm, config options
SDK Reference — all methods and event types
Framework Examples — Lovable, Bolt.new, Next.js, plain HTML
Dashboard Guide — what all the screens do