Introduction
Privacy-first product analytics for the apps you ship. Add it by hand in five minutes, or let your coding agent do it.
Let your agent do it
1 prompt · Claude Code, Cursor, Codex…Add Shipabase analytics to this app using the @shipabase/js package. Read node_modules/@shipabase/js/llms.txt first and follow it exactly. 1. Install @shipabase/js with this project's package manager. 2. Call init() once on the client at app startup, with the app key from an env var (NEXT_PUBLIC_SHIPABASE_KEY for Next.js, VITE_SHIPABASE_KEY for Vite, SHIPABASE_KEY for Node). In Next.js App Router, do it in a "use client" providers component inside useEffect, and wrap app/layout.tsx with it. 3. Find the 5–10 most important user actions (signup, core feature used, upgrade, etc.) and add trackEvent() calls named in snake_case object_verb form (e.g. project_created). 4. Props: only non-personal values (plan, count, duration, variant). NEVER emails, names, user IDs, IPs or free text typed by users. 5. Show me the list of events you added, then tell me to open the Shipabase dashboard Setup page to confirm the first event arrived.
Paste it in your agent, at the root of your project.
Shipabase counts visitors, visits, events and sessions without cookies, without storing IP addresses, and with a JavaScript SDK of about 2 KB. Page views are tracked automatically; events are one line each. These docs are written to be read by humans and followed by coding agents.