Skip to content

Commit 329ac74

Browse files
committed
update wizard instructions and add troubleshooting item
1 parent 852127c commit 329ac74

File tree

5 files changed

+96
-41
lines changed

5 files changed

+96
-41
lines changed

docs/platforms/javascript/common/troubleshooting/index.mdx

Lines changed: 42 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -470,21 +470,21 @@ Learn more about fixing these caching issues in the <PlatformLink to="/sourcemap
470470
471471
```json {tabTitle:npm} {filename:package.json}
472472
"overrides": {
473-
"@vercel/nft": "^0.27.4"
474-
}
473+
"@vercel/nft": "^0.27.4"
474+
}
475475
```
476476
477477
```json {tabTitle:yarn} {filename:package.json}
478478
"resolutions": {
479-
"@vercel/nft": "^0.27.4"
480-
}
479+
"@vercel/nft": "^0.27.4"
480+
}
481481
```
482482
483483
```json {tabTitle:pnpm} {filename:package.json}
484484
"pnpm": {
485-
"overrides": {
486-
"@vercel/nft": "^0.27.4"
487-
}
485+
"overrides": {
486+
"@vercel/nft": "^0.27.4"
487+
}
488488
}
489489
```
490490
@@ -501,6 +501,41 @@ Learn more about fixing these caching issues in the <PlatformLink to="/sourcemap
501501
pnpm add import-in-the-middle
502502
```
503503
</Expandable>
504+
505+
<Expandable permalink title="Nuxt: Server-side Nitro is not sending events">
506+
Nuxt builds the server-side Nitro application as ES Modules, which introduces limitations for server-side tracing during development.
507+
Currently, trace collection is only supported when running the built application, not in development mode (`nuxt dev`).
508+
To collect traces, build your project and run the production build output.
509+
510+
---
511+
512+
We are currently investigating an issue where the server-side is not correctly initialized with a recent update of Nitro (the server-side toolkit in Nuxt).
513+
514+
We are working on figuring this out ([see issue here](https://github.com/getsentry/sentry-javascript/issues/14514)). For the time being, you can add the following overrides to your application:
515+
516+
```json {tabTitle:npm} {filename:package.json}
517+
"overrides": {
518+
"nitropack": "2.9.7"
519+
"@vercel/nft": "^0.27.4"
520+
}
521+
```
522+
523+
```json {tabTitle:yarn} {filename:package.json}
524+
"resolutions": {
525+
"nitropack": "2.9.7"
526+
"@vercel/nft": "^0.27.4"
527+
}
528+
```
529+
530+
```json {tabTitle:pnpm} {filename:package.json}
531+
"pnpm": {
532+
"overrides": {
533+
"nitropack": "2.9.7"
534+
"@vercel/nft": "^0.27.4"
535+
}
536+
}
537+
```
538+
</Expandable>
504539
</PlatformSection>
505540
506541
If you need additional help, you can [ask on GitHub](https://github.com/getsentry/sentry-javascript/issues/new/choose). Customers on a paid plan may also contact support.

docs/platforms/javascript/guides/nuxt/manual-setup.mdx

Lines changed: 27 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,33 @@ If you can't (or prefer not to) run the <PlatformLink to="/#install">automatic s
88

99
## Compatibility
1010

11-
The minimum supported Nuxt version is `3.7.0`.
11+
The Sentry Nuxt SDK supports Nuxt version `3.7.0` and above. For best results, we recommend
12+
using Nuxt `3.14.0` or later, which includes updated dependencies critical to the SDK's functionality.
13+
14+
In case you are using Nuxt before version `3.14.0`, add the following overrides:
15+
16+
```json {tabTitle:npm} {filename:package.json}
17+
"overrides": {
18+
"ofetch": "^1.4.0"
19+
"@vercel/nft": "^0.27.4"
20+
}
21+
```
22+
23+
```json {tabTitle:yarn} {filename:package.json}
24+
"resolutions": {
25+
"ofetch": "^1.4.0"
26+
"@vercel/nft": "^0.27.4"
27+
}
28+
```
29+
30+
```json {tabTitle:pnpm} {filename:package.json}
31+
"pnpm": {
32+
"overrides": {
33+
"ofetch": "^1.4.0"
34+
"@vercel/nft": "^0.27.4"
35+
}
36+
}
37+
```
1238

1339
## Install
1440

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,4 @@
11
## Next Steps
22

33
- Track your Vue Components or your Pinia store by [adding support for client features](/platforms/javascript/guides/nuxt/features/)
4-
- In case you experience any issues during setup or startup, check out <PlatformLink to="/troubleshooting">Troubleshooting</PlatformLink>
5-
6-
7-
or read through the different <PlatformLink to="/install">installation methods</PlatformLink>.
4+
- In case you experience any issues during setup or startup, check out <PlatformLink to="/troubleshooting">Troubleshooting</PlatformLink>.

platform-includes/getting-started-primer/javascript.nuxt.mdx

Lines changed: 24 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -8,35 +8,30 @@ Sentry's Nuxt SDK enables automatic reporting of errors and performance data.
88

99
## Compatibility
1010

11-
The minimum supported Nuxt version is `3.7.0`.
12-
13-
<Note>
14-
We are currently investigating an issue where the server-side is not correctly initialized with a recent update of Nitro (the server-side toolkit in Nuxt).
15-
16-
We are working on figuring this out ([see issue here](https://github.com/getsentry/sentry-javascript/issues/14514)). For the time being, you can add the following overrides to your application:
17-
18-
<br/>
19-
20-
```json {tabTitle:npm} {filename:package.json}
11+
The Sentry Nuxt SDK supports Nuxt version `3.7.0` and above. For best results, we recommend
12+
using Nuxt `3.14.0` or later, which includes updated dependencies critical to the SDK's functionality.
13+
14+
In case you are using Nuxt before version `3.14.0`, add the following overrides:
15+
16+
```json {tabTitle:npm} {filename:package.json}
17+
"overrides": {
18+
"ofetch": "^1.4.0"
19+
"@vercel/nft": "^0.27.4"
20+
}
21+
```
22+
23+
```json {tabTitle:yarn} {filename:package.json}
24+
"resolutions": {
25+
"ofetch": "^1.4.0"
26+
"@vercel/nft": "^0.27.4"
27+
}
28+
```
29+
30+
```json {tabTitle:pnpm} {filename:package.json}
31+
"pnpm": {
2132
"overrides": {
22-
"nitropack": "2.9.7"
33+
"ofetch": "^1.4.0"
2334
"@vercel/nft": "^0.27.4"
2435
}
25-
```
26-
27-
```json {tabTitle:yarn} {filename:package.json}
28-
"resolutions": {
29-
"nitropack": "2.9.7"
30-
"@vercel/nft": "^0.27.4"
31-
}
32-
```
33-
34-
```json {tabTitle:pnpm} {filename:package.json}
35-
"pnpm": {
36-
"overrides": {
37-
"nitropack": "2.9.7"
38-
"@vercel/nft": "^0.27.4"
39-
}
40-
}
41-
```
42-
</Note>
36+
}
37+
```

platform-includes/getting-started-verify/javascript.nuxt.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,4 +51,6 @@ export default defineEventHandler(event => {
5151
# Start your app after building your project with `nuxi build`
5252
node .output/server/index.mjs
5353
```
54+
55+
In case you experience any issues with the server-side setup, check out <PlatformLink to="/troubleshooting">Troubleshooting</PlatformLink>.
5456
</Alert>

0 commit comments

Comments
 (0)