Skip to content

feat(tanstackstart-react): Add guide for setup without --import#16594

Open
nicohrubec wants to merge 4 commits intomasterfrom
nh/tss-serverless-setup
Open

feat(tanstackstart-react): Add guide for setup without --import#16594
nicohrubec wants to merge 4 commits intomasterfrom
nh/tss-serverless-setup

Conversation

@nicohrubec
Copy link
Member

@nicohrubec nicohrubec commented Feb 26, 2026

For serverless environments where users can't set --import flag on startup we need a slightly different setup, where users need to import the instrument.server.mjs in the server entry file. So far we have no documentation for that, so I split the docs to set up server-side Sentry into two sections (one for normal node setup, one for serverless environments). The described setup should work starting from the next SDK release.

@vercel
Copy link

vercel bot commented Feb 26, 2026

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

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Feb 27, 2026 1:18pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Feb 27, 2026 1:18pm

Request Review

}
```

#### Serverless (e.g. Vercel, Netlify)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

m: We should list limitations with this approach. You can look at how we did that for other SDKs.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

right good call, added!

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@nicohrubec also now that I think about it, we should not call this "Serverless", have a look at https://docs.sentry.io/platforms/javascript/guides/nuxt/install/cli-import/#scenarios-where---import-does-not-work

Maybe we can rephrase this heading similarly.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sure I changed the section names to reflect that the deciding difference is whether users can set --import or not

Copy link
Member

@andreiborza andreiborza left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@nicohrubec nicohrubec changed the title feat(tanstackstart-react): Add guide for serverless setup feat(tanstackstart-react): Add guide for setup without --import Feb 27, 2026
Copy link
Member

@andreiborza andreiborza left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, this makes it much clearer now!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants