feat: add nuxt support #2372

ablaszkiewicz · 2025-09-26T13:04:43Z

This PR adds a support for nuxt. Nuxt has this thing in its ecosystem called modules. This is our nuxt module.

What it does:

hooks itself into the build process to inject and upload source maps to posthog,
spawns frontend posthog client for Vue using posthog-js and subscribes to vue error hook,
spawns backend posthog client for Nitro using posthog-node and subcribes to nitro error hook,
let's you override config for both frontend and backend.

I recorded this loom video to show how it works

vercel · 2025-09-26T13:04:48Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Updated (UTC)
posthog-js	Ready	Preview	Oct 10, 2025 11:15am

github-actions · 2025-10-07T09:51:54Z

Download bundle size visualization

github-actions · 2025-10-07T09:52:35Z

Size Change: 0 B

Total Size: 4.82 MB

ℹ️ View Unchanged

Filename	Size
`packages/ai/dist/anthropic/index.cjs`	16.7 kB
`packages/ai/dist/anthropic/index.mjs`	16.5 kB
`packages/ai/dist/gemini/index.cjs`	17.6 kB
`packages/ai/dist/gemini/index.mjs`	17.5 kB
`packages/ai/dist/index.cjs`	120 kB
`packages/ai/dist/index.mjs`	119 kB
`packages/ai/dist/langchain/index.cjs`	39.6 kB
`packages/ai/dist/langchain/index.mjs`	39 kB
`packages/ai/dist/openai/index.cjs`	29.8 kB
`packages/ai/dist/openai/index.mjs`	29.5 kB
`packages/ai/dist/vercel/index.cjs`	21.9 kB
`packages/ai/dist/vercel/index.mjs`	21.9 kB
`packages/browser/dist/all-external-dependencies.js`	223 kB
`packages/browser/dist/array.full.es5.js`	290 kB
`packages/browser/dist/array.full.js`	357 kB
`packages/browser/dist/array.full.no-external.js`	371 kB
`packages/browser/dist/array.js`	157 kB
`packages/browser/dist/array.no-external.js`	168 kB
`packages/browser/dist/crisp-chat-integration.js`	1.97 kB
`packages/browser/dist/customizations.full.js`	19.1 kB
`packages/browser/dist/dead-clicks-autocapture.js`	12.6 kB
`packages/browser/dist/exception-autocapture.js`	11.6 kB
`packages/browser/dist/external-scripts-loader.js`	2.81 kB
`packages/browser/dist/intercom-integration.js`	2.02 kB
`packages/browser/dist/lazy-recorder.js`	147 kB
`packages/browser/dist/main.js`	158 kB
`packages/browser/dist/module.full.js`	358 kB
`packages/browser/dist/module.full.no-external.js`	371 kB
`packages/browser/dist/module.js`	158 kB
`packages/browser/dist/module.no-external.js`	169 kB
`packages/browser/dist/posthog-recorder.js`	241 kB
`packages/browser/dist/recorder-v2.js`	113 kB
`packages/browser/dist/recorder.js`	113 kB
`packages/browser/dist/surveys-preview.js`	71.1 kB
`packages/browser/dist/surveys.js`	80 kB
`packages/browser/dist/tracing-headers.js`	1.84 kB
`packages/browser/dist/web-vitals.js`	10.4 kB
`packages/browser/react/dist/esm/index.js`	15.1 kB
`packages/browser/react/dist/umd/index.js`	17.8 kB
`packages/core/dist/error-tracking/chunk-ids.js`	2.54 kB
`packages/core/dist/error-tracking/chunk-ids.mjs`	1.31 kB
`packages/core/dist/error-tracking/coercers/dom-exception-coercer.js`	2.3 kB
`packages/core/dist/error-tracking/coercers/dom-exception-coercer.mjs`	993 B
`packages/core/dist/error-tracking/coercers/error-coercer.js`	2.02 kB
`packages/core/dist/error-tracking/coercers/error-coercer.mjs`	794 B
`packages/core/dist/error-tracking/coercers/error-event-coercer.js`	1.76 kB
`packages/core/dist/error-tracking/coercers/error-event-coercer.mjs`	513 B
`packages/core/dist/error-tracking/coercers/event-coercer.js`	1.82 kB
`packages/core/dist/error-tracking/coercers/event-coercer.mjs`	548 B
`packages/core/dist/error-tracking/coercers/index.js`	6.79 kB
`packages/core/dist/error-tracking/coercers/index.mjs`	326 B
`packages/core/dist/error-tracking/coercers/object-coercer.js`	3.46 kB
`packages/core/dist/error-tracking/coercers/object-coercer.mjs`	2.07 kB
`packages/core/dist/error-tracking/coercers/primitive-coercer.js`	1.67 kB
`packages/core/dist/error-tracking/coercers/primitive-coercer.mjs`	419 B
`packages/core/dist/error-tracking/coercers/promise-rejection-event.js`	2.25 kB
`packages/core/dist/error-tracking/coercers/promise-rejection-event.mjs`	904 B
`packages/core/dist/error-tracking/coercers/string-coercer.js`	2.01 kB
`packages/core/dist/error-tracking/coercers/string-coercer.mjs`	820 B
`packages/core/dist/error-tracking/coercers/utils.js`	2.06 kB
`packages/core/dist/error-tracking/coercers/utils.mjs`	716 B
`packages/core/dist/error-tracking/error-properties-builder.js`	5.64 kB
`packages/core/dist/error-tracking/error-properties-builder.mjs`	4.24 kB
`packages/core/dist/error-tracking/index.js`	4.11 kB
`packages/core/dist/error-tracking/index.mjs`	152 B
`packages/core/dist/error-tracking/parsers/base.js`	1.84 kB
`packages/core/dist/error-tracking/parsers/base.mjs`	472 B
`packages/core/dist/error-tracking/parsers/chrome.js`	2.7 kB
`packages/core/dist/error-tracking/parsers/chrome.mjs`	1.29 kB
`packages/core/dist/error-tracking/parsers/gecko.js`	2.45 kB
`packages/core/dist/error-tracking/parsers/gecko.mjs`	1.11 kB
`packages/core/dist/error-tracking/parsers/index.js`	4.36 kB
`packages/core/dist/error-tracking/parsers/index.mjs`	1.92 kB
`packages/core/dist/error-tracking/parsers/node.js`	3.95 kB
`packages/core/dist/error-tracking/parsers/node.mjs`	2.68 kB
`packages/core/dist/error-tracking/parsers/opera.js`	2.22 kB
`packages/core/dist/error-tracking/parsers/opera.mjs`	706 B
`packages/core/dist/error-tracking/parsers/react-native.js`	203 B
`packages/core/dist/error-tracking/parsers/react-native.mjs`	0 B	🆕
`packages/core/dist/error-tracking/parsers/safari.js`	1.88 kB
`packages/core/dist/error-tracking/parsers/safari.mjs`	574 B
`packages/core/dist/error-tracking/parsers/winjs.js`	1.7 kB
`packages/core/dist/error-tracking/parsers/winjs.mjs`	406 B
`packages/core/dist/error-tracking/types.js`	1.33 kB
`packages/core/dist/error-tracking/types.mjs`	131 B
`packages/core/dist/error-tracking/utils.js`	1.8 kB
`packages/core/dist/error-tracking/utils.mjs`	604 B
`packages/core/dist/eventemitter.js`	1.78 kB
`packages/core/dist/eventemitter.mjs`	571 B
`packages/core/dist/featureFlagUtils.js`	6.5 kB
`packages/core/dist/featureFlagUtils.mjs`	4.28 kB
`packages/core/dist/gzip.js`	1.88 kB
`packages/core/dist/gzip.mjs`	577 B
`packages/core/dist/index.js`	5.7 kB
`packages/core/dist/index.mjs`	485 B
`packages/core/dist/logger.js`	2.46 kB
`packages/core/dist/logger.mjs`	1.17 kB
`packages/core/dist/posthog-core-stateless.js`	29.3 kB
`packages/core/dist/posthog-core-stateless.mjs`	26.8 kB
`packages/core/dist/posthog-core.js`	28.1 kB
`packages/core/dist/posthog-core.mjs`	24 kB
`packages/core/dist/process/index.js`	2.27 kB
`packages/core/dist/process/index.mjs`	35 B
`packages/core/dist/process/spawn-local.js`	2.33 kB
`packages/core/dist/process/spawn-local.mjs`	1.01 kB
`packages/core/dist/process/utils.js`	3.11 kB
`packages/core/dist/process/utils.mjs`	1.15 kB
`packages/core/dist/testing/index.js`	2.93 kB
`packages/core/dist/testing/index.mjs`	79 B
`packages/core/dist/testing/PostHogCoreTestClient.js`	3.15 kB
`packages/core/dist/testing/PostHogCoreTestClient.mjs`	1.74 kB
`packages/core/dist/testing/test-utils.js`	2.77 kB
`packages/core/dist/testing/test-utils.mjs`	1.09 kB
`packages/core/dist/types.js`	8.2 kB
`packages/core/dist/types.mjs`	5.93 kB
`packages/core/dist/utils/bucketed-rate-limiter.js`	3.14 kB
`packages/core/dist/utils/bucketed-rate-limiter.mjs`	1.76 kB
`packages/core/dist/utils/index.js`	9.26 kB
`packages/core/dist/utils/index.mjs`	1.88 kB
`packages/core/dist/utils/number-utils.js`	2 kB
`packages/core/dist/utils/number-utils.mjs`	735 B
`packages/core/dist/utils/promise-queue.js`	2 kB
`packages/core/dist/utils/promise-queue.mjs`	768 B
`packages/core/dist/utils/string-utils.js`	1.91 kB
`packages/core/dist/utils/string-utils.mjs`	414 B
`packages/core/dist/utils/type-utils.js`	6.93 kB
`packages/core/dist/utils/type-utils.mjs`	3.03 kB
`packages/core/dist/vendor/uuidv7.js`	8.29 kB
`packages/core/dist/vendor/uuidv7.mjs`	6.72 kB
`packages/nextjs-config/dist/config.js`	5.51 kB
`packages/nextjs-config/dist/config.mjs`	4.03 kB
`packages/nextjs-config/dist/index.js`	2.24 kB
`packages/nextjs-config/dist/index.mjs`	30 B
`packages/nextjs-config/dist/utils.js`	3.74 kB
`packages/nextjs-config/dist/utils.mjs`	1.87 kB
`packages/nextjs-config/dist/webpack-plugin.js`	3.69 kB
`packages/nextjs-config/dist/webpack-plugin.mjs`	1.98 kB
`packages/node/dist/client.js`	22.4 kB
`packages/node/dist/client.mjs`	20.6 kB
`packages/node/dist/entrypoints/index.edge.js`	4.14 kB
`packages/node/dist/entrypoints/index.edge.mjs`	652 B
`packages/node/dist/entrypoints/index.node.js`	5.08 kB
`packages/node/dist/entrypoints/index.node.mjs`	901 B
`packages/node/dist/exports.js`	3.6 kB
`packages/node/dist/exports.mjs`	124 B
`packages/node/dist/extensions/error-tracking/autocapture.js`	2.65 kB
`packages/node/dist/extensions/error-tracking/autocapture.mjs`	1.23 kB
`packages/node/dist/extensions/error-tracking/index.js`	3.88 kB
`packages/node/dist/extensions/error-tracking/index.mjs`	2.61 kB
`packages/node/dist/extensions/error-tracking/modifiers/context-lines.node.js`	8.81 kB
`packages/node/dist/extensions/error-tracking/modifiers/context-lines.node.mjs`	7.15 kB
`packages/node/dist/extensions/error-tracking/modifiers/module.node.js`	2.78 kB
`packages/node/dist/extensions/error-tracking/modifiers/module.node.mjs`	1.45 kB
`packages/node/dist/extensions/express.js`	2.17 kB
`packages/node/dist/extensions/express.mjs`	548 B
`packages/node/dist/extensions/feature-flags/crypto.js`	1.57 kB
`packages/node/dist/extensions/feature-flags/crypto.mjs`	395 B
`packages/node/dist/extensions/feature-flags/feature-flags.js`	26.8 kB
`packages/node/dist/extensions/feature-flags/feature-flags.mjs`	25 kB
`packages/node/dist/extensions/sentry-integration.js`	4.7 kB
`packages/node/dist/extensions/sentry-integration.mjs`	3.21 kB
`packages/node/dist/storage-memory.js`	1.52 kB
`packages/node/dist/storage-memory.mjs`	297 B
`packages/node/dist/types.js`	603 B
`packages/node/dist/types.mjs`	0 B	🆕
`packages/node/dist/version.js`	1.21 kB
`packages/node/dist/version.mjs`	45 B
`packages/nuxt/dist/module.mjs`	4.29 kB
`packages/nuxt/dist/runtime/nitro-plugin.js`	994 B
`packages/nuxt/dist/runtime/vue-plugin.js`	652 B
`packages/react-native/dist/autocapture.js`	4.68 kB
`packages/react-native/dist/error-tracking/index.js`	6.63 kB
`packages/react-native/dist/error-tracking/utils.js`	2.58 kB
`packages/react-native/dist/frameworks/wix-navigation.js`	1.3 kB
`packages/react-native/dist/hooks/useFeatureFlag.js`	1.49 kB
`packages/react-native/dist/hooks/useFeatureFlags.js`	821 B
`packages/react-native/dist/hooks/useNavigationTracker.js`	2.46 kB
`packages/react-native/dist/hooks/usePostHog.js`	467 B
`packages/react-native/dist/index.js`	3.12 kB
`packages/react-native/dist/native-deps.js`	13.9 kB
`packages/react-native/dist/optional/OptionalAsyncStorage.js`	299 B
`packages/react-native/dist/optional/OptionalExpoApplication.js`	377 B
`packages/react-native/dist/optional/OptionalExpoDevice.js`	347 B
`packages/react-native/dist/optional/OptionalExpoFileSystem.js`	386 B
`packages/react-native/dist/optional/OptionalExpoFileSystemLegacy.js`	423 B
`packages/react-native/dist/optional/OptionalExpoLocalization.js`	383 B
`packages/react-native/dist/optional/OptionalReactNativeDeviceInfo.js`	415 B
`packages/react-native/dist/optional/OptionalReactNativeLocalize.js`	303 B
`packages/react-native/dist/optional/OptionalReactNativeNavigation.js`	415 B
`packages/react-native/dist/optional/OptionalReactNativeNavigationWix.js`	443 B
`packages/react-native/dist/optional/OptionalReactNativeSafeArea.js`	644 B
`packages/react-native/dist/optional/OptionalSessionReplay.js`	455 B
`packages/react-native/dist/posthog-rn.js`	30.5 kB
`packages/react-native/dist/PostHogContext.js`	329 B
`packages/react-native/dist/PostHogProvider.js`	4.77 kB
`packages/react-native/dist/storage.js`	3.39 kB
`packages/react-native/dist/surveys/components/BottomSection.js`	1.34 kB
`packages/react-native/dist/surveys/components/Cancel.js`	909 B
`packages/react-native/dist/surveys/components/ConfirmationMessage.js`	1.58 kB
`packages/react-native/dist/surveys/components/QuestionHeader.js`	1.11 kB
`packages/react-native/dist/surveys/components/QuestionTypes.js`	10.1 kB
`packages/react-native/dist/surveys/components/SurveyModal.js`	3.86 kB
`packages/react-native/dist/surveys/components/Surveys.js`	7.18 kB
`packages/react-native/dist/surveys/getActiveMatchingSurveys.js`	3.48 kB
`packages/react-native/dist/surveys/icons.js`	7.76 kB
`packages/react-native/dist/surveys/index.js`	600 B
`packages/react-native/dist/surveys/PostHogSurveyProvider.js`	5.61 kB
`packages/react-native/dist/surveys/surveys-utils.js`	9.31 kB
`packages/react-native/dist/surveys/useActivatedSurveys.js`	3.38 kB
`packages/react-native/dist/surveys/useSurveyStorage.js`	2.16 kB
`packages/react-native/dist/types.js`	70 B
`packages/react-native/dist/utils.js`	539 B
`packages/react-native/dist/version.js`	129 B
`packages/react/dist/esm/index.js`	15.1 kB
`packages/react/dist/umd/index.js`	17.8 kB
`packages/web/dist/index.cjs`	13.8 kB
`packages/web/dist/index.mjs`	13.7 kB
`tooling/rollup-utils/dist/index.js`	1.17 kB

_{compressed-size-action}

greptile-apps

_{17 files reviewed, 9 comments}

_{Edit Code Review Agent Settings | Greptile}

packages/nuxt/package.json

packages/nuxt/README.md

packages/nuxt/src/module.ts

packages/nuxt/src/runtime/vue-plugin.ts

packages/nuxt/src/runtime/nitro-plugin.ts

daibhin

Couple of comments but this is really promising

packages/nuxt/README.md

packages/nuxt/package.json

packages/nuxt/src/runtime/nitro-plugin.ts

packages/nuxt/src/module.ts

feat: add changeset feat: adjust error message feat: move cli to a dedicated export feat: revert fix: further revert feat: change cli utils export strategy feat: make call binary more generic feat: make call binary more generic feat: update changeset feat: pass nextjs without tests feat: add nuxt module feat: wip

packages/nuxt/README.md

Chippd · 2025-10-31T13:10:31Z

@ablaszkiewicz thanks for the video - it was very helpful. Can I ask where you're getting the envID to use in the config? I'm seeing errors when building and trying to upload the sourcemaps

ablaszkiewicz · 2025-10-31T14:45:05Z

@Chippd you can get it from the URL when you're on the posthog app website.

https://us.posthog.com/project/<env-id>

Chippd · 2025-10-31T19:20:39Z

@ablaszkiewicz cool thanks - I suspected it was the same as "Project ID" but this confirms it.

vercel bot had a problem deploying to Preview September 26, 2025 13:08 Failure

vercel bot had a problem deploying to Preview September 26, 2025 13:15 Failure

vercel bot had a problem deploying to Preview September 26, 2025 13:17 Failure

vercel bot had a problem deploying to Preview September 26, 2025 13:28 Failure

vercel bot deployed to Preview September 26, 2025 13:33 View deployment

vercel bot deployed to Preview September 26, 2025 14:15 View deployment

vercel bot deployed to Preview October 2, 2025 14:05 View deployment

vercel bot deployed to Preview October 6, 2025 09:16 View deployment

vercel bot deployed to Preview October 6, 2025 10:10 View deployment

vercel bot deployed to Preview October 6, 2025 10:21 View deployment

vercel bot deployed to Preview October 6, 2025 12:32 View deployment

vercel bot deployed to Preview October 7, 2025 08:26 View deployment

vercel bot had a problem deploying to Preview October 7, 2025 09:26 Failure

vercel bot had a problem deploying to Preview October 7, 2025 09:35 Failure

ablaszkiewicz force-pushed the nuxt branch from 0f9232c to 8d0532a Compare October 7, 2025 09:48

vercel bot deployed to Preview October 7, 2025 09:53 View deployment

ablaszkiewicz marked this pull request as ready for review October 7, 2025 11:11

ablaszkiewicz requested review from a team, daibhin, hpouillot, ioannisj, marandaneto and oliverb123 October 7, 2025 11:12

greptile-apps bot reviewed Oct 7, 2025

View reviewed changes

vercel bot deployed to Preview October 7, 2025 11:19 View deployment

vercel bot deployed to Preview October 7, 2025 11:46 View deployment

daibhin reviewed Oct 7, 2025

View reviewed changes

ablaszkiewicz force-pushed the nuxt branch from 73ba1e0 to 6ad5d62 Compare October 9, 2025 12:38

feat: wip

7fddf84

vercel bot had a problem deploying to Preview October 9, 2025 12:45 Failure

feat: wip

56fccce

vercel bot deployed to Preview October 9, 2025 13:40 View deployment

feat: wip

7b7ede5

vercel bot deployed to Preview October 9, 2025 14:14 View deployment

ablaszkiewicz added 3 commits October 9, 2025 16:15

feat: wip

734110f

feat: update example readme

74f951d

feat: wip

0bba43a

ablaszkiewicz requested review from daibhin and hpouillot October 9, 2025 14:20

vercel bot deployed to Preview October 9, 2025 14:26 View deployment

fix: lint

587178e

vercel bot deployed to Preview October 9, 2025 14:32 View deployment

hpouillot reviewed Oct 9, 2025

View reviewed changes

packages/nuxt/README.md Outdated Show resolved Hide resolved

hpouillot reviewed Oct 9, 2025

View reviewed changes

packages/nuxt/README.md Outdated Show resolved Hide resolved

hpouillot approved these changes Oct 9, 2025

View reviewed changes

feat: update nuxt module readme

9ada812

vercel bot deployed to Preview October 10, 2025 09:45 View deployment

feat: add changeset

27d3c65

ablaszkiewicz added the release label Oct 10, 2025

vercel bot deployed to Preview October 10, 2025 11:15 View deployment

ablaszkiewicz merged commit 30ac39d into main Oct 10, 2025
30 checks passed

ablaszkiewicz deleted the nuxt branch October 10, 2025 11:33

ablaszkiewicz mentioned this pull request Oct 13, 2025

feat: document new nuxt module PostHog/posthog.com#13190

Merged

5 tasks

feat: add nuxt support #2372

feat: add nuxt support #2372

Uh oh!

Conversation

ablaszkiewicz commented Sep 26, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel bot commented Sep 26, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Oct 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Oct 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

greptile-apps bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

daibhin left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Chippd commented Oct 31, 2025

Uh oh!

ablaszkiewicz commented Oct 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Chippd commented Oct 31, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

ablaszkiewicz commented Sep 26, 2025 •

edited

Loading

vercel bot commented Sep 26, 2025 •

edited

Loading

github-actions bot commented Oct 7, 2025 •

edited

Loading

github-actions bot commented Oct 7, 2025 •

edited

Loading

ablaszkiewicz commented Oct 31, 2025 •

edited

Loading