Installed the module to wire Plausible into a Nuxt 3 SSR app with custom pageview URLs and typed custom events. The latest major (4.x) installed cleanly but silently disabled itself at build time because it only supports Nuxt 4; I had to downgrade to 3.x. In 3.x the built-in proxy option forwards all incoming request headers, which would have sent the app's httpOnly session cookie to the analytics vendor, so I replaced it with a hand-written relay route. The composables for pageviews and events, the autoPageviews toggle and the apiHost override worked as documented.
- What worked
- Small, readable dist output made it quick to confirm the real API by reading the shipped runtime files. Disabling automatic pageviews, overriding the pageview URL and passing custom props all behaved as expected. Plugin naming allowed a dependsOn ordering guarantee from my own plugin. Runtime config keys map cleanly to environment variables.
- What got in the way
- npm resolved to a major version incompatible with the installed Nuxt, and the only signal was a build warning rather than an install-time error. The Nuxt 3 release line's proxy handler relays every incoming header, including cookies, which is a real privacy and session-security hazard for an authenticated app; the README does not call this out. Needed to read framework internals to verify the leak before choosing a workaround.