fix: nuxt v4

Author: JeanMeijer

examples/nuxt-v4/app/app.vue

@@ -1,6 +1,12 @@
+<script setup lang="ts">
+if (import.meta.server) {
+  await trackPageview();
+}
+</script>
+
 <template>
   <div>
     <NuxtRouteAnnouncer />
-    <NuxtWelcome />
+    <NuxtPage />
   </div>
 </template>

examples/nuxt-v4/app/middleware/tracking-middleware.ts

@@ -0,0 +1,12 @@
+export default defineNuxtRouteMiddleware(async (to) => {
+  // We track pageviews on the server only
+  if (import.meta.client) {
+    return;
+  }
+
+  if (to.path.startsWith("/api/")) {
+    return;
+  }
+
+  await trackPageview();
+});

examples/nuxt-v4/nuxt.config.ts

@@ -2,4 +2,5 @@
 export default defineNuxtConfig({
   compatibilityDate: "2025-07-15",
   devtools: { enabled: true },
+  modules: ["@simpleanalytics/nuxt"],
 });

examples/nuxt-v4/server/api/track-event.post.ts

@@ -0,0 +1,23 @@
+import { defineEventHandler, createError } from "h3";
+
+export default defineEventHandler(async (event) => {
+  try {
+    await trackEvent("button_clicked", {
+      event,
+      metadata: {
+        source: "test_page",
+      },
+    });
+
+    return {
+      success: true,
+      message: "Button click event tracked successfully",
+    };
+  } catch (error) {
+    console.error("Error tracking event:", error);
+    throw createError({
+      statusCode: 500,
+      statusMessage: "Failed to track event",
+    });
+  }
+});

packages/nuxt/package.json

@@ -36,7 +36,8 @@
     "test:types": "vue-tsc --noEmit && cd playground && vue-tsc --noEmit"
   },
   "dependencies": {
-    "@nuxt/kit": "^4.0.2"
+    "@nuxt/kit": "^4.0.2",
+    "simple-analytics-vue": "^3.0.3"
   },
   "devDependencies": {
     "@nuxt/devtools": "^2.6.2",
@@ -47,7 +48,7 @@
     "@types/node": "^24.2.0",
     "changelogen": "^0.6.2",
     "eslint": "^9.32.0",
-    "nuxt": "^3 || ^4",
+    "nuxt": "^4",
     "typescript": "~5.9.2",
     "vitest": "^3.2.4",
     "vue-tsc": "^3.0.5"

packages/nuxt/src/module.ts

@@ -4,6 +4,7 @@ import {
   addServerHandler,
   addImports,
   addServerImports,
+  addPlugin,
 } from "@nuxt/kit";
 import type { SimpleAnalyticsOptions } from "./runtime/server/lib/options";
 
@@ -35,7 +36,7 @@ export default defineNuxtModule<ModuleOptions>({
 
     nuxt.options.runtimeConfig.public.simpleAnalytics = configOptions;
 
-    // addPlugin(resolver.resolve('./runtime/plugin'))
+    addPlugin(resolver.resolve("./runtime/plugin"));
 
     addImports([
       {

packages/nuxt/src/runtime/client/component.ts

@@ -1,4 +1,13 @@
-import { defineNuxtPlugin } from "#app";
+import { useRuntimeConfig } from "#imports";
+import { defineNuxtPlugin } from "nuxt/app";
 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-export default defineNuxtPlugin((nuxtApp) => {});
+import SimpleAnalytics from "simple-analytics-vue";
+
+export default defineNuxtPlugin((nuxtApp) => {
+  const config = useRuntimeConfig();
+
+  nuxtApp.vueApp.use(SimpleAnalytics, {
+    skip: !config.public.simpleAnalytics.enabled,
+    domain: config.public.simpleAnalytics.domain,
+  });
+});

packages/nuxt/src/runtime/plugin.ts

@@ -1,6 +1,7 @@
 export interface SimpleAnalyticsOptions {
   autoCollect?: boolean;
   collectDnt?: boolean;
+  domain?: string;
   hostname?: string;
   mode?: "dash";
   ignoreMetrics?: {

packages/nuxt/src/runtime/server/lib/options.ts

@@ -8,6 +8,7 @@ declare module "@nuxt/schema" {
     simpleAnalytics: {
       autoCollect?: boolean;
       collectDnt?: boolean;
+      domain?: string;
       hostname?: string;
       mode?: "dash";
       ignoreMetrics?: {