Privacy-first analytics for a Nuxt site, in one module. No cookies, no personal data, and the script it adds to your pages is under 3 KB.
Pulse Analytics is built by Ciphera, a company in Belgium, and hosted in Europe.
npx nuxi module add @ciphera-net/pulse-nuxtOr by hand:
npm install -D @ciphera-net/pulse-nuxt// nuxt.config.ts
export default defineNuxtConfig({
modules: ["@ciphera-net/pulse-nuxt"],
pulse: { domain: "example.com" },
})That is the whole setup. domain is the hostname your site is registered under
in Pulse — if a site-config module (@nuxtjs/sitemap, @nuxtjs/robots,
@nuxtjs/seo) already gives you a site.url, you can leave it out and the
module reads the hostname from there.
You need a Pulse Analytics account with a site registered for the same domain. The free plan is enough to start.
| Option | Default | What it does |
|---|---|---|
domain |
from site.url |
The domain your site is registered under in Pulse Analytics. Pass this when site.url is not the domain you track, for example on a preview deployment. |
apiUrl |
— | Route events through your own proxy origin. A bare origin (https://example.com), not a full URL: the tracker appends its own path. |
trackScroll |
true |
Record scroll depth. |
trackOutbound |
true |
Record outbound link clicks as outbound_link events. |
trackDownloads |
true |
Record file download clicks as file_download events. |
companion |
false |
Also record clicks, copies and form submits. A second, separate script — see below. true records all three; an object turns individual ones off. |
injectInDev |
false |
Inject during nuxt dev too. Off by default — see below. |
pulse: {
domain: "example.com",
companion: { copy: false },
trackScroll: false,
}It does not run in nuxt dev. The tracker has no localhost guard, so a dev
server would send real pageviews at your production dashboard. The module prints
a line saying it stayed out. Set injectInDev: true if you actually want it.
The interaction capture is a second request on purpose. The core script's
size is a published claim, and nothing gets folded into it to make a feature
look free. companion: true costs you a second, separate file.
View-source shows the tag itself. Unlike the Astro and Framer integrations,
this module adds a real <script src> to app.head, so the tag Nuxt renders is
byte-for-byte the one you would paste into a layout by hand, and no JavaScript
of ours reaches your bundle. It works with a strict Content-Security-Policy that
forbids inline script.
Then you may not need this module. Pulse is a first-party entry in the
Nuxt Scripts registry as useScriptPulseAnalytics,
which gives you loading triggers, consent gating and a typed track() you can
call from a component. The option names here (domain, apiUrl, trackScroll,
trackOutbound, trackDownloads) are deliberately the same, so moving either
way is a copy and paste.
Take this module when you want the tag and nothing else; take @nuxt/scripts
when you want the tag and a way to fire events from your components. Do not
install both — they would each add a tag, and the pageviews would double.
Pageviews, referrers, countries, devices, time on page and scroll depth, plus goals, funnels and campaigns. It sets no cookies and stores no personal data. Visitors whose browser sends Do Not Track or Global Privacy Control are not counted at all — so if you test in Brave or Firefox and see nothing, that is the tracker behaving correctly. Safari is the easiest browser to verify an install in.
Nuxt 3 and Nuxt 4. The range is measured, not asserted: npm run verify builds
a real Nuxt site on each major and reads the tag out of the emitted HTML.
Nuxt 2 is refused with an error — its head is Vue Meta and a different shape
entirely.
Copyright 2026 Ciphera BV. Licensed under the Apache License, Version 2.0 —
the LICENSE file is the licence text verbatim, so the copyright line lives
here rather than inside it.
This package has zero runtime dependencies, asserted in CI.
Nuxt is a trademark of its owners; this is an independent module and is not affiliated with or endorsed by the Nuxt project.