test(tanstackstart): Add TanStack Start on Cloudflare Workers test app by JPeer264 · Pull Request #20649 · getsentry/sentry-javascript

JPeer264 · 2026-05-04T12:44:19Z

Adds an e2e test application for TanStack Start deployed to Cloudflare Workers using @sentry/cloudflare. The setup uses a custom server entry point that wraps the TanStack Start handler with Sentry.withSentry.

Unfortunately the type safety is not great yet with Sentry.withSentry and TanStack Start, so this needs to be adapted in another PR (or in v11 if it is not yet possible).

Closes #18669

JPeer264 · 2026-05-04T12:45:48Z

+export const Route = createRootRoute({
+  head: () => {
+    const traceData = getTraceData();
+    const sentryMeta = Object.entries(traceData).map(([key, value]) => ({


Not sure if this is the best way in TanStack to add trace propagation, couldn't find anything specific in the docs

I have never looked into this, does that work? If yes that's amazing then we can document how to set that up :)

JPeer264 · 2026-05-04T12:46:10Z

+    tracesSampleRate: 1.0,
+    environment: 'qa',
+  }),
+  // @ts-expect-error - handler is not typed as a Cloudflare handler


This is the type error

JPeer264 · 2026-05-04T12:46:42Z

+  expect(errorEvent.contexts?.trace?.span_id).toEqual(expect.any(String));
+});
+
+// Note: API route errors in TanStack Start are handled internally by the framework


~~I added a note there. I think the TanStack Start middleware won't work in Cloudflare (yet?), as the middleware is somehow added with the tanstack start SDK?!~~

that works now 😎

cursor · 2026-05-04T12:51:31Z

+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "preview": "wrangler dev --var E2E_TEST_DSN:$E2E_TEST_DSN --log-level=$(test $CI && echo 'none' || echo 'log')",


Missing quotes around --var value in preview script

Medium Severity

The preview script passes --var E2E_TEST_DSN:$E2E_TEST_DSN without quotes around the value. Every other Cloudflare test app in the repo (cloudflare-workers, cloudflare-local-workers, cloudflare-mcp, cloudflare-workersentrypoint, astro-6-cf-workers) uses the quoted form --var \"E2E_TEST_DSN:$E2E_TEST_DSN\". Since DSN values contain shell-sensitive characters like :// and @, the unquoted expansion could cause parsing issues depending on the shell environment in CI.

^{Reviewed by Cursor Bugbot for commit 8dd6f21. Configure here.}

github-actions · 2026-05-04T12:56:27Z

size-limit report 📦

Path	Size	% Change	Change
@sentry/browser	26.3 kB	-	-
@sentry/browser - with treeshaking flags	24.78 kB	-	-
@sentry/browser (incl. Tracing)	44.17 kB	-	-
@sentry/browser (incl. Tracing + Span Streaming)	46.39 kB	-	-
@sentry/browser (incl. Tracing, Profiling)	49.14 kB	-	-
@sentry/browser (incl. Tracing, Replay)	83.55 kB	-	-
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags	73.01 kB	-	-
@sentry/browser (incl. Tracing, Replay with Canvas)	88.23 kB	-	-
@sentry/browser (incl. Tracing, Replay, Feedback)	100.84 kB	-	-
@sentry/browser (incl. Feedback)	43.44 kB	-	-
@sentry/browser (incl. sendFeedback)	31.11 kB	-	-
@sentry/browser (incl. FeedbackAsync)	36.19 kB	-	-
@sentry/browser (incl. Metrics)	27.6 kB	-	-
@sentry/browser (incl. Logs)	27.73 kB	-	-
@sentry/browser (incl. Metrics & Logs)	28.43 kB	-	-
@sentry/react	28.04 kB	-	-
@sentry/react (incl. Tracing)	46.4 kB	-	-
@sentry/vue	31.18 kB	-	-
@sentry/vue (incl. Tracing)	46.02 kB	-	-
@sentry/svelte	26.32 kB	-	-
CDN Bundle	28.91 kB	-	-
CDN Bundle (incl. Tracing)	46.94 kB	-	-
CDN Bundle (incl. Logs, Metrics)	30.34 kB	-	-
CDN Bundle (incl. Tracing, Logs, Metrics)	48.04 kB	-	-
CDN Bundle (incl. Replay, Logs, Metrics)	69.4 kB	-	-
CDN Bundle (incl. Tracing, Replay)	84.07 kB	-	-
CDN Bundle (incl. Tracing, Replay, Logs, Metrics)	85.15 kB	-	-
CDN Bundle (incl. Tracing, Replay, Feedback)	89.89 kB	-	-
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics)	90.97 kB	-	-
CDN Bundle - uncompressed	84.88 kB	-	-
CDN Bundle (incl. Tracing) - uncompressed	140.44 kB	-	-
CDN Bundle (incl. Logs, Metrics) - uncompressed	89.08 kB	-	-
CDN Bundle (incl. Tracing, Logs, Metrics) - uncompressed	143.9 kB	-	-
CDN Bundle (incl. Replay, Logs, Metrics) - uncompressed	212.99 kB	-	-
CDN Bundle (incl. Tracing, Replay) - uncompressed	258.24 kB	-	-
CDN Bundle (incl. Tracing, Replay, Logs, Metrics) - uncompressed	261.69 kB	-	-
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed	271.94 kB	-	-
CDN Bundle (incl. Tracing, Replay, Feedback, Logs, Metrics) - uncompressed	275.38 kB	-	-
@sentry/nextjs (client)	48.9 kB	-	-
@sentry/sveltekit (client)	44.64 kB	-	-
@sentry/node-core	59.81 kB	+0.02%	+9 B 🔺
@sentry/node	163.43 kB	+0.01%	+7 B 🔺
@sentry/node - without tracing	72.28 kB	+0.02%	+9 B 🔺
@sentry/aws-serverless	106.95 kB	+0.01%	+7 B 🔺
@sentry/cloudflare (withSentry) - minified	166.9 kB	-	-
@sentry/cloudflare (withSentry)	421.79 kB	-	-

View base workflow run

cursor · 2026-05-05T16:15:41Z

+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "preview": "wrangler dev --var E2E_TEST_DSN:$E2E_TEST_DSN --log-level=$(test $CI && echo 'none' || echo 'log')",


Preview bypasses built app

Medium Severity

The preview script starts wrangler dev, but this app is built through @cloudflare/vite-plugin. wrangler dev bypasses the Vite preview output that pnpm build creates, so Playwright can run a source Worker without the generated TanStack assets instead of the Cloudflare build under test.

^{Reviewed by Cursor Bugbot for commit d4d6179. Configure here.}

…test app

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

There are 3 total unresolved issues (including 2 from previous reviews).

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 2d2ea64. Configure here.}

cursor · 2026-05-05T16:25:46Z

+
+  const clientTransactionPromise = waitForTransaction('tanstackstart-react-cloudflare', transactionEvent => {
+    return transactionEvent?.contexts?.trace?.op === 'pageload' && transactionEvent?.transaction === '/';
+  });


Telemetry wait can flake

Low Severity

This hits the project rule about flaky telemetry waits: the GET / transaction predicate can match delayed root transactions from earlier tests. If serverTransactionPromise resolves with an older request, the trace comparison uses unrelated server and client events and flakes.

^{Triggered by project rule: PR Review Guidelines for Cursor Bot}

^{Reviewed by Cursor Bugbot for commit 2d2ea64. Configure here.}

can't hurt using a longer route I guess

nicohrubec · 2026-05-06T06:37:36Z

+export const Route = createRootRoute({
+  head: () => {
+    const traceData = getTraceData();
+    const sentryMeta = Object.entries(traceData).map(([key, value]) => ({


I have never looked into this, does that work? If yes that's amazing then we can document how to set that up :)

nicohrubec · 2026-05-06T11:30:48Z

+  server: {
+    port: 3030,
+  },
+  plugins: [cloudflare({ viteEnvironment: { name: 'ssr' } }), tsConfigPaths(), tanstackStart(), viteReact()],


q: have you tried using the sentry vite plugin here?

nicohrubec · 2026-05-06T11:32:11Z

+    environment: 'qa',
+  }),
+  // @ts-expect-error - handler is not typed as a Cloudflare handler
+  handler,


q: wondering if we could wrap this handler with wrapFetchWithSentry somehow? right now it's not that important but would future-proof us if that works

nicohrubec · 2026-05-06T11:33:43Z

+
+  const clientTransactionPromise = waitForTransaction('tanstackstart-react-cloudflare', transactionEvent => {
+    return transactionEvent?.contexts?.trace?.op === 'pageload' && transactionEvent?.transaction === '/';
+  });


can't hurt using a longer route I guess

nicohrubec · 2026-05-06T11:37:40Z

+
+export const Route = createFileRoute('/ssr-error')({
+  loader: () => {
+    throw new Error('Sentry SSR Test Error');


l: this as well as the flush endpoint are not used I think? in other Tanstack Start apps we have a test that asserts that ssr errors are not captured (where this is used). fine to leave this out for this one I think but then we could trim down the application a bit (i.e. remove the flush endpoint and ssr error)

JPeer264 requested a review from nicohrubec May 4, 2026 12:44

JPeer264 self-assigned this May 4, 2026

test(tanstackstart): Add TanStack Start on Cloudflare Workers test app

8dd6f21

JPeer264 force-pushed the jp/tanstack-start-cloudflare branch from e581ac8 to 8dd6f21 Compare May 4, 2026 12:44

JPeer264 commented May 4, 2026

View reviewed changes

cursor Bot reviewed May 4, 2026

View reviewed changes

cursor Bot reviewed May 5, 2026

View reviewed changes

fixup! test(tanstackstart): Add TanStack Start on Cloudflare Workers …

2d2ea64

…test app

JPeer264 force-pushed the jp/tanstack-start-cloudflare branch from d4d6179 to 2d2ea64 Compare May 5, 2026 16:20

cursor Bot reviewed May 5, 2026

View reviewed changes

nicohrubec reviewed May 6, 2026

View reviewed changes

nicohrubec mentioned this pull request May 6, 2026

docs(cloudflare): Add TanStack Start on Cloudflare docs getsentry/sentry-docs#17595

Open

6 tasks

Uh oh!

Conversation

JPeer264 commented May 4, 2026 • edited by nicohrubec Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

JPeer264 May 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor Bot May 4, 2026

Choose a reason for hiding this comment

Missing quotes around --var value in preview script

Uh oh!

github-actions Bot commented May 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

size-limit report 📦

Uh oh!

cursor Bot May 5, 2026

Choose a reason for hiding this comment

Preview bypasses built app

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot May 5, 2026

Choose a reason for hiding this comment

Telemetry wait can flake

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

JPeer264 commented May 4, 2026 •

edited by nicohrubec

Loading

JPeer264 May 4, 2026 •

edited

Loading

Missing quotes around `--var` value in preview script

github-actions Bot commented May 4, 2026 •

edited

Loading