Quick Start

Get sessionvision running on your site in under 5 minutes. No build step required — just paste a script tag and start collecting data.

1. Sign Up

New signups are paused while SessionVision transitions to a new brand. Existing customers can still sign in at app.sessionvision.com to grab their project token (it looks like sv_pub_...).

2. Run the Install Wizard

The wizard auto-detects your project's framework and package manager, installs the SDK, saves your token, and sends a test event — all in one step.

npx @sessionvision/install-wizard

It supports Next.js, React, Vue, Nuxt, static HTML, Rails, Django, Flask, and Node.js. If you have an existing analytics SDK (PostHog, Mixpanel, Segment, Amplitude), the wizard will flag it so you can migrate at your own pace.

After running, check .sessionvision/INSTALL.md in your project for framework-specific instructions. If you prefer to set things up manually, skip to the next step.

Option	Description
`--token <token>`	`Pass your project token directly (skip the prompt)`
`--frontend-only`	`Only set up browser-side tracking`
`--backend-only`	`Only set up server-side tracking`
`--dry-run`	`Preview changes without writing any files`
`--no-install`	`Skip package installation`

3. Add the Snippet (manual)

If you didn't use the install wizard, paste this snippet into the <head> of every page you want to track:

<script>
!function(){"use strict";!function(s,n){const t=n.sessionvision;
if(t&&t.__SV)return;const e={_i:[],_q:[],init:function(n,t){
e._i.push([n,t]);const i=["capture","identify","reset",
"getDistinctId","register","registerOnce"];for(const s of i)
e[s]=function(...n){e._q.push([s,...n])};const o=s.createElement("script");
o.async=!0;const c=t?.version||"latest";
o.src=(t?.apiHost||"https://cdn.sessionvision.com")+"/"+
(/^\d/.test(c)?"v"+c:c)+"/sessionvision.min.js";
const r=s.getElementsByTagName("script")[0];
r&&r.parentNode?r.parentNode.insertBefore(o,r):
s.head.appendChild(o)}};n.sessionvision=e}(document,window)}();

sessionvision.init('YOUR_PROJECT_TOKEN');
</script>

Replace YOUR_PROJECT_TOKEN with the token from your project settings.

4. Verify

Visit your site, click around, and navigate between pages. Then open your sessionvision dashboard — you should see $pageview, $click, and $form_submit events appearing within seconds.

Enable debug: true in the config to log all captured events to the browser console:

sessionvision.init('YOUR_PROJECT_TOKEN', { debug: true });

5. Identify users

When a user logs in, call identify() to link their activity to a user ID. All future events will be associated with this user.

sessionvision.identify('user_123', {
  email: '[email protected]',
  name: 'Jane Doe',
  plan: 'pro',
});

Call reset() on logout to clear the identity and start a new anonymous session.