Observability

Sentry is an optional paid-provider integration. It is not included in the free template. Use this page only if your project has Sentry installed and you have your own provider keys.

Sentry

When configured, Sentry captures unhandled errors, performance traces, and request context.

Backend

When Sentry is configured, the backend error middleware reports unexpected errors automatically. You don't need to add Sentry.captureException() calls manually. Typed application errors (404s, validation failures) are returned to the client but not reported, since they're expected behavior.

Frontend

When VITE_SENTRY_DSN is set, Sentry is initialized in the app entry point and captures:

• Unhandled exceptions and promise rejections
• React component errors via the error boundary
• Performance traces for navigation and API calls

Configuration

Set these env variables:

# Backend
SENTRY_DSN=https://your-dsn@sentry.io/123

# Frontend
VITE_SENTRY_DSN=https://your-dsn@sentry.io/456

Disabling in development

Both services check for the presence of their env variables. Leave them empty in your .env file to disable tracking locally.