# Introduction

> Privacy-first product analytics for the apps you ship. Add it by hand in five minutes, or let your coding agent do it.

Source: https://shipabase.dev/docs

## Let your agent do it

Paste this into Claude Code, Cursor or another coding agent:

```text
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.
```

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.

- [Quickstart](https://shipabase.dev/docs/quickstart.md): Install the SDK, call init once, and see your first event. Five minutes, no cookie banner.
- [For AI agents](https://shipabase.dev/docs/ai-agents.md): Shipabase is built to be installed by a coding agent. Give it one prompt, it reads the rules, you review the diff.
- [Next.js](https://shipabase.dev/docs/nextjs.md): Add Shipabase to a Next.js App Router project.
- [React (Vite)](https://shipabase.dev/docs/react.md): Add Shipabase to a React app built with Vite.
- [Vue & Svelte](https://shipabase.dev/docs/vue-svelte.md): Add Shipabase to a Vue or Svelte app built with Vite, or to SvelteKit.
- [React Native & Expo](https://shipabase.dev/docs/react-native.md): Track screens and events in a mobile app built with Expo or React Native.
- [Node.js](https://shipabase.dev/docs/node.md): Track events from API servers, CLIs, scripts and cron jobs.
- [Page views](https://shipabase.dev/docs/page-views.md): Pages are tracked automatically in the browser. Screens in mobile apps take one line.
- [Naming events](https://shipabase.dev/docs/naming-events.md): Short, stable names make every chart readable.
- [Props & privacy](https://shipabase.dev/docs/props.md): Add context to events without collecting personal data.
- [Sessions](https://shipabase.dev/docs/sessions.md): How visits are grouped, and how conversions are counted.
- [Verify your setup](https://shipabase.dev/docs/verify.md): See your first event, and fix it when nothing shows up.
- [API reference](https://shipabase.dev/docs/api.md): Three functions. None of them throw, and calls before init are ignored.
- [Privacy](https://shipabase.dev/docs/privacy.md): What the SDK sends, how visitors are counted, and what you should never send.