feat: sentry integration (#1020) (#1029)

* feat: add Sentry error tracking integration

Configure via NEXT_PUBLIC_SENTRY_DSN environment variable.

* chore: clean up Sentry wizard output

- Remove unneeded server/edge configs (static export)
- Remove App Router files (using Pages Router)
- Remove example pages
- Use env var for DSN instead of hardcoding
- Add typed _error.tsx for Pages Router error capture

* chore: suppress Sentry global-error.js warning

Not needed for Pages Router projects.

* feat: add environment tag to Sentry errors

Uses NEXT_PUBLIC_SITE_CONFIG to segment errors by environment.

* feat: enable Sentry for dev and prod environments

Add DSN to site-config env files.

Author: dannon

.env

@@ -1,3 +1,7 @@
 NEXT_PUBLIC_SITEMAP_DOMAIN='https://brc-analytics.dev.clevercanary.com'
 NEXT_PUBLIC_BASE_PATH=''
 SITEMAP_EXCLUDE='/export*,/login'
+# Sentry configuration (optional - leave empty to disable)
+NEXT_PUBLIC_SENTRY_DSN=''
+# Suppress warning about App Router global-error.js (we use Pages Router)
+SENTRY_SUPPRESS_GLOBAL_ERROR_HANDLER_FILE_WARNING=1

.gitignore

@@ -42,6 +42,10 @@ backend/**/.env
 venv
 __pycache__
 
+playwright-report/
 
 ## public api
 /public/api
+
+# Sentry Config File
+.env.sentry-build-plugin

instrumentation-client.ts

@@ -0,0 +1,10 @@
+import * as Sentry from "@sentry/nextjs";
+
+Sentry.init({
+  dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
+  enabled: !!process.env.NEXT_PUBLIC_SENTRY_DSN,
+  environment: process.env.NEXT_PUBLIC_SITE_CONFIG || "unknown",
+  tracesSampleRate: 1,
+});
+
+export const onRouterTransitionStart = Sentry.captureRouterTransitionStart;

next.config.mjs

@@ -1,3 +1,4 @@
+import { withSentryConfig } from "@sentry/nextjs";
 import nextMDX from "@next/mdx";
 import withPlugins from "next-compose-plugins";
 import path from "path";
@@ -13,7 +14,8 @@ const ESM_PACKAGES = [
 const withMDX = nextMDX({
   extension: /\.mdx?$/,
 });
-export default withPlugins(
+
+const nextConfig = withPlugins(
   [[withMDX, { pageExtensions: ["md", "mdx", "ts", "tsx"] }]],
   {
     basePath: "",
@@ -86,3 +88,15 @@ export default withPlugins(
     },
   }
 );
+
+export default withSentryConfig(nextConfig, {
+  disableLogger: true,
+  org: "galaxy",
+  project: "brc-analytics-dev",
+  sentryUrl: "https://sentry.galaxyproject.org/",
+  silent: true,
+  sourcemaps: {
+    disable: true,
+  },
+  suppressGlobalErrorHandlerFileWarning: true,
+});