Team-Timo · ehye1 · Jun 26, 2026 · Jun 25, 2026 · Jun 25, 2026 · Jun 25, 2026
diff --git a/apps/timo-web/app/global-error.tsx b/apps/timo-web/app/global-error.tsx
@@ -0,0 +1,25 @@
+"use client";
+
+import * as Sentry from "@sentry/nextjs";
+import { useEffect } from "react";
+
+interface GlobalErrorProps {
+  error: Error & { digest?: string };
+  reset: () => void;
+}
+
+export default function GlobalError({ error, reset }: GlobalErrorProps) {
+  useEffect(() => {
+    Sentry.captureException(error);
+  }, [error]);
+
+  return (
+    <html lang="ko">
+      <body>
+        <h1>문제가 발생했어요</h1>
+        <p>잠시 후 다시 시도해주세요.</p>
+        <button onClick={reset}>다시 시도</button>
+      </body>
+    </html>
+  );
+}
diff --git a/apps/timo-web/instrumentation-client.ts b/apps/timo-web/instrumentation-client.ts
@@ -0,0 +1,12 @@
+import * as Sentry from "@sentry/nextjs";
+
+const dsn = process.env.NEXT_PUBLIC_SENTRY_DSN;
+
+if (dsn) {
+  Sentry.init({
+    dsn,
+    environment: process.env.NEXT_PUBLIC_SENTRY_ENVIRONMENT ?? "local",
+  });
+}
+
+export const onRouterTransitionStart = Sentry.captureRouterTransitionStart;
diff --git a/apps/timo-web/instrumentation.ts b/apps/timo-web/instrumentation.ts
@@ -0,0 +1,13 @@
+import * as Sentry from "@sentry/nextjs";
+
+export async function register() {
+  if (process.env.NEXT_RUNTIME === "nodejs") {
+    await import("./sentry.server.config");
+  }
+
+  if (process.env.NEXT_RUNTIME === "edge") {
+    await import("./sentry.edge.config");
+  }
+}
+
+export const onRequestError = Sentry.captureRequestError;
diff --git a/apps/timo-web/next.config.js b/apps/timo-web/next.config.js
@@ -1,6 +1,16 @@
+/* global process */
+import { withSentryConfig } from "@sentry/nextjs";
+
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   transpilePackages: ["@repo/timo-design-system"],
 };
 
-export default nextConfig;
+export default withSentryConfig(nextConfig, {
+  org: "timo-client",
+  project: "timo-web",
+  authToken: process.env["SENTRY_AUTH_TOKEN"],
+  silent: !process.env.CI,
+  widenClientFileUpload: true,
+  disableLogger: true,
+});
diff --git a/apps/timo-web/package.json b/apps/timo-web/package.json
@@ -12,6 +12,7 @@
   },
   "dependencies": {
     "@repo/timo-design-system": "workspace:*",
+    "@sentry/nextjs": "^10.61.0",
     "@tanstack/react-query": "^5.101.1",
     "@tanstack/react-query-devtools": "^5.101.1",
     "axios": "^1.18.1",

diff --git a/apps/timo-web/sentry.edge.config.ts b/apps/timo-web/sentry.edge.config.ts
@@ -0,0 +1,10 @@
+import * as Sentry from "@sentry/nextjs";
+
+const dsn = process.env.NEXT_PUBLIC_SENTRY_DSN;
+
+if (dsn) {
+  Sentry.init({
+    dsn,
+    environment: process.env.NEXT_PUBLIC_SENTRY_ENVIRONMENT ?? "local",
+  });
+}
diff --git a/apps/timo-web/sentry.server.config.ts b/apps/timo-web/sentry.server.config.ts
@@ -0,0 +1,10 @@
+import * as Sentry from "@sentry/nextjs";
+
+const dsn = process.env.NEXT_PUBLIC_SENTRY_DSN;
+
+if (dsn) {
+  Sentry.init({
+    dsn,
+    environment: process.env.NEXT_PUBLIC_SENTRY_ENVIRONMENT ?? "local",
+  });
+}