Shipabase docs: cookieless analytics for AI-built apps
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.
QuickstartInstall, init, first event. Five minutes.FrameworksNext.js, React, Vue, Svelte, Expo, Node.Events & sessionsNaming, props, how sessions work.PrivacyNo cookies, no IP stored. How we count.API referenceinit, trackEvent, flush. Every option.Verify your setupSee your first event arrive.
Related guides
DocsQuickstart: cookieless analytics in 5 minutesInstall the SDK, call init once, and see your first event. Five minutes, no cookie banner.DocsInstall analytics with an AI coding agent (prompt + MCP)Shipabase is built to be installed by a coding agent. Give it one prompt, it reads the rules, you review the diff.DocsNext.js analytics setup (App Router), cookielessAdd Shipabase to a Next.js App Router project.DocsHow Shipabase counts visitors without cookies or stored IPsWhat the SDK sends, how visitors are counted, and what you should never send.BlogHow to add analytics to a Lovable appTwo ways to track what users do in an app built with Lovable: one prompt, or three lines of code. Cookieless, no consent banner for the SDK.BlogAnalytics MCP server for Claude Code, Cursor and CodexConnect an analytics MCP server to Claude Code or Cursor. Your agent installs cookieless tracking, checks the first event and reads your stats.