Full Sentry SDK setup for TanStack Start React. Use when asked to "add Sentry to TanStack Start", "install @sentry/tanstackstart-react", or configure error monitoring, tracing, session replay, logs, or user feedback in a TanStack Start React app.
sentry-tanstack-start-sdk is an opinionated setup wizard for adding the Sentry SDK to a TanStack Start React application, covering both browser and server runtimes. It solves the fiddly, error-prone task of wiring Sentry correctly across TanStack Start's client entry, server entry, middleware, and build tooling, guiding the user through error monitoring, tracing, session replay, logs, and user feedback.
The skill runs in three phases. Detect inspects the project (grepping package.json for TanStack and Sentry packages, checking for router/server entry files and vite config, and detecting whether a source-map-upload token is configured) to understand the setup before recommending anything. Recommend leads with a concrete proposal — error monitoring, tracing, and session replay as the core, with logs and user feedback as optional add-ons — rather than open-ended questions. Guide then walks through installing @sentry/tanstackstart-react and configuring the required server error hooks, the Vite plugin, instrument.server.mjs runtime startup, and enrichment APIs. Reference files detail error monitoring, tracing, session replay, logging, user feedback, and framework-specific features.
It is aimed at React developers using TanStack Start who want production-grade error and performance monitoring. Its credential handling follows standard, safe practice: it detects whether SENTRY_AUTH_TOKEN is present by grepping local env files for source-map upload, and reads the token from an environment variable in the Vite config rather than hardcoding or exfiltrating it. The skill notes the SDK is currently alpha and advises verifying against official docs.
A complete Sentry SDK installation for TanStack Start React, including error monitoring, tracing, session replay, logs, and user feedback across both browser and server runtimes.
A TanStack Start React project (documented as compatible with TanStack Start 1.0 RC) and, for source-map upload, a SENTRY_AUTH_TOKEN available in the environment or CI.
It is read from the SENTRY_AUTH_TOKEN environment variable in the Vite config (optionally via loadEnv or .env.sentry-build-plugin) and used only for Sentry source-map upload. The skill detects its presence by grepping local env files but does not transmit it elsewhere.
The SKILL.md notes the @sentry/tanstackstart-react SDK is currently alpha and documented as compatible with TanStack Start 1.0 RC, and advises verifying against the official Sentry docs before implementing.
It sets up instrument.server.mjs with server-side Sentry.init, wraps the handler with wrapFetchWithSentry in src/server.ts, and adds sentryGlobalRequestMiddleware and sentryGlobalFunctionMiddleware in src/start.ts.
Quick Setup:
.claude/skills/Repository
getsentry/sentry-for-ai