B2B-88: add starter kit structure and elements

packages/monitoring/api/README.md

@@ -0,0 +1,39 @@
+# Monitoring / @kit/monitoring
+
+Please set the following environment variable to your preferred monitoring provider:
+
+```
+NEXT_PUBLIC_MONITORING_PROVIDER=
+ENABLE_MONITORING_INSTRUMENTATION=true
+```
+
+## Available Providers
+
+To use a specific provider, set the `NEXT_PUBLIC_MONITORING_PROVIDER` environment variable to one of the following values:
+
+1. Baselime: `baselime`
+2. Sentry: `sentry`
+
+## Baselime
+
+To use Baselime, set the `NEXT_PUBLIC_MONITORING_PROVIDER` environment variable to `baselime`.
+
+```
+NEXT_PUBLIC_MONITORING_PROVIDER=baselime
+```
+
+## Sentry
+
+To use Sentry, set the `NEXT_PUBLIC_MONITORING_PROVIDER` environment variable to `sentry`.
+
+```
+NEXT_PUBLIC_MONITORING_PROVIDER=sentry
+```
+
+## Instrumentation
+
+To enable instrumentation, set the `ENABLE_MONITORING_INSTRUMENTATION` environment variable to `true`.
+
+```
+ENABLE_MONITORING_INSTRUMENTATION=true
+```

packages/monitoring/api/eslint.config.mjs

@@ -0,0 +1,3 @@
+import eslintConfigBase from '@kit/eslint-config/base.js';
+
+export default eslintConfigBase;

packages/monitoring/api/node_modules/@kit/baselime

@@ -0,0 +1 @@
+../../../baselime

packages/monitoring/api/node_modules/@kit/eslint-config

@@ -0,0 +1 @@
+../../../../../tooling/eslint

packages/monitoring/api/node_modules/@kit/monitoring-core

@@ -0,0 +1 @@
+../../../core

packages/monitoring/api/node_modules/@kit/prettier-config

@@ -0,0 +1 @@
+../../../../../tooling/prettier

packages/monitoring/api/node_modules/@kit/sentry

@@ -0,0 +1 @@
+../../../sentry

packages/monitoring/api/node_modules/@kit/shared

@@ -0,0 +1 @@
+../../../../shared

packages/monitoring/api/node_modules/@kit/tsconfig

@@ -0,0 +1 @@
+../../../../../tooling/typescript

packages/monitoring/api/node_modules/@types/react

@@ -0,0 +1 @@
+../../../../../node_modules/.pnpm/@types+react@19.1.4/node_modules/@types/react

packages/monitoring/api/node_modules/react

@@ -0,0 +1 @@
+../../../../node_modules/.pnpm/react@19.1.0/node_modules/react

packages/monitoring/api/node_modules/zod

@@ -0,0 +1 @@
+../../../../node_modules/.pnpm/zod@3.25.56/node_modules/zod

packages/monitoring/api/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@kit/monitoring",
+  "private": true,
+  "sideEffects": false,
+  "version": "0.1.0",
+  "scripts": {
+    "clean": "git clean -xdf ../.turbo node_modules",
+    "format": "prettier --check \"**/*.{ts,tsx}\"",
+    "lint": "eslint ..",
+    "typecheck": "tsc --noEmit"
+  },
+  "prettier": "@kit/prettier-config",
+  "exports": {
+    "./server": "./src/server.ts",
+    "./instrumentation": "./src/instrumentation.ts",
+    "./hooks": "./src/hooks/index.ts",
+    "./components": "./src/components/index.ts"
+  },
+  "devDependencies": {
+    "@kit/baselime": "workspace:*",
+    "@kit/eslint-config": "workspace:*",
+    "@kit/monitoring-core": "workspace:*",
+    "@kit/prettier-config": "workspace:*",
+    "@kit/sentry": "workspace:*",
+    "@kit/shared": "workspace:*",
+    "@kit/tsconfig": "workspace:*",
+    "@types/react": "19.1.4",
+    "react": "19.1.0",
+    "zod": "^3.24.4"
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "src/*"
+      ]
+    }
+  }
+}

packages/monitoring/api/src/components/error-boundary.tsx

@@ -0,0 +1,35 @@
+import type { ErrorInfo, ReactNode } from 'react';
+import { Component } from 'react';
+
+interface Props {
+  onError?: (error: Error, info: ErrorInfo) => void;
+  fallback: ReactNode;
+  children: ReactNode;
+}
+
+export class ErrorBoundary extends Component<Props> {
+  readonly state = { hasError: false, error: null };
+
+  constructor(props: Props) {
+    super(props);
+  }
+
+  static getDerivedStateFromError(error: unknown) {
+    return {
+      hasError: true,
+      error,
+    };
+  }
+
+  componentDidCatch(error: Error, info: ErrorInfo) {
+    this.props.onError?.(error, info);
+  }
+
+  render() {
+    if (this.state.hasError) {
+      return this.props.fallback;
+    }
+
+    return this.props.children;
+  }
+}

packages/monitoring/api/src/components/index.ts

@@ -0,0 +1,2 @@
+export * from './error-boundary';
+export * from './provider';

packages/monitoring/api/src/components/provider.tsx

@@ -0,0 +1,67 @@
+'use client';
+
+import { lazy } from 'react';
+
+import { createRegistry } from '@kit/shared/registry';
+
+import {
+  MonitoringProvider as MonitoringProviderType,
+  getMonitoringProvider,
+} from '../get-monitoring-provider';
+
+// Define the type for our provider components
+type ProviderComponent = {
+  default: React.ComponentType<React.PropsWithChildren>;
+};
+
+const provider = getMonitoringProvider();
+
+const Provider = provider
+  ? lazy(() => monitoringProviderRegistry.get(provider))
+  : null;
+
+// Create a registry for monitoring providers
+const monitoringProviderRegistry = createRegistry<
+  ProviderComponent,
+  NonNullable<MonitoringProviderType>
+>();
+
+// Register the Baselime provider
+monitoringProviderRegistry.register('baselime', async () => {
+  const { BaselimeProvider } = await import('@kit/baselime/provider');
+
+  return {
+    default: function BaselimeProviderWrapper({
+      children,
+    }: React.PropsWithChildren) {
+      return <BaselimeProvider enableWebVitals>{children}</BaselimeProvider>;
+    },
+  };
+});
+
+// Register the Sentry provider
+monitoringProviderRegistry.register('sentry', async () => {
+  const { SentryProvider } = await import('@kit/sentry/provider');
+
+  return {
+    default: function SentryProviderWrapper({
+      children,
+    }: React.PropsWithChildren) {
+      return <SentryProvider>{children}</SentryProvider>;
+    },
+  };
+});
+
+/**
+ * @name MonitoringProvider
+ * @description This component is used to wrap the application with the appropriate monitoring provider.
+ * @param props
+ * @returns
+ */
+export function MonitoringProvider(props: React.PropsWithChildren) {
+  if (!Provider) {
+    return <>{props.children}</>;
+  }
+
+  return <Provider>{props.children}</Provider>;
+}

packages/monitoring/api/src/get-monitoring-provider.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+
+export const MONITORING_PROVIDER = z
+  .enum(['baselime', 'sentry', ''])
+  .optional()
+  .transform((value) => value || undefined);
+
+export type MonitoringProvider = z.infer<typeof MONITORING_PROVIDER>;
+
+export function getMonitoringProvider() {
+  return MONITORING_PROVIDER.parse(process.env.NEXT_PUBLIC_MONITORING_PROVIDER);
+}

packages/monitoring/api/src/hooks/index.ts

@@ -0,0 +1,2 @@
+export * from './use-monitoring';
+export * from './use-capture-exception';

packages/monitoring/api/src/hooks/use-capture-exception.ts

@@ -0,0 +1,11 @@
+import { useEffect } from 'react';
+
+import { useMonitoring } from './use-monitoring';
+
+export function useCaptureException(error: Error) {
+  const service = useMonitoring();
+
+  useEffect(() => {
+    void service.captureException(error);
+  }, [error, service]);
+}

packages/monitoring/api/src/hooks/use-monitoring.ts

@@ -0,0 +1,14 @@
+'use client';
+
+import { useContext } from 'react';
+
+import { MonitoringContext } from '@kit/monitoring-core';
+
+/**
+ * @name useMonitoring
+ * @description Asynchronously load the monitoring service based on the MONITORING_PROVIDER environment variable.
+ * Use Suspense to suspend while loading the service.
+ */
+export function useMonitoring() {
+  return useContext(MonitoringContext);
+}

packages/monitoring/api/src/instrumentation.ts

@@ -0,0 +1,51 @@
+import { createRegistry } from '@kit/shared/registry';
+
+import {
+  MonitoringProvider,
+  getMonitoringProvider,
+} from './get-monitoring-provider';
+
+// Define a type for the instrumentation registration implementation
+type InstrumentationRegistration = {
+  register: () => Promise<void> | void;
+};
+
+// Create a registry for instrumentation providers, using literal strings 'baselime' and 'sentry'
+const instrumentationRegistry = createRegistry<
+  InstrumentationRegistration,
+  NonNullable<MonitoringProvider>
+>();
+
+// Register the 'baselime' instrumentation provider
+instrumentationRegistry.register('baselime', async () => {
+  const { registerInstrumentation } = await import(
+    '@kit/baselime/instrumentation'
+  );
+
+  return { register: registerInstrumentation };
+});
+
+// Register the 'sentry' instrumentation provider with a no-op registration, since Sentry v8 sets up automatically
+instrumentationRegistry.register('sentry', () => {
+  return {
+    register: () => {
+      return;
+    },
+  };
+});
+
+/**
+ * @name registerMonitoringInstrumentation
+ * @description Register monitoring instrumentation based on the MONITORING_PROVIDER environment variable using the registry internally.
+ */
+export async function registerMonitoringInstrumentation() {
+  const provider = getMonitoringProvider();
+
+  if (!provider) {
+    return;
+  }
+
+  const instrumentation = await instrumentationRegistry.get(provider);
+
+  return instrumentation.register();
+}

packages/monitoring/api/src/server.ts

@@ -0,0 +1 @@
+export * from './services/get-server-monitoring-service';

packages/monitoring/api/src/services/get-server-monitoring-service.ts

@@ -0,0 +1,52 @@
+import {
+  ConsoleMonitoringService,
+  MonitoringService,
+} from '@kit/monitoring-core';
+import { createRegistry } from '@kit/shared/registry';
+
+import {
+  MonitoringProvider,
+  getMonitoringProvider,
+} from '../get-monitoring-provider';
+
+// create a registry for the server monitoring services
+const serverMonitoringRegistry = createRegistry<
+  MonitoringService,
+  NonNullable<MonitoringProvider>
+>();
+
+// Register the 'baselime' monitoring service
+serverMonitoringRegistry.register('baselime', async () => {
+  const { BaselimeServerMonitoringService } = await import(
+    '@kit/baselime/server'
+  );
+
+  return new BaselimeServerMonitoringService();
+});
+
+// Register the 'sentry' monitoring service
+serverMonitoringRegistry.register('sentry', async () => {
+  const { SentryMonitoringService } = await import('@kit/sentry');
+
+  return new SentryMonitoringService();
+});
+
+// if you have a new monitoring provider, you can register it here
+//
+
+/**
+ * @name getServerMonitoringService
+ * @description Get the monitoring service based on the MONITORING_PROVIDER environment variable.
+ */
+export async function getServerMonitoringService() {
+  const provider = getMonitoringProvider();
+
+  if (!provider) {
+    console.info(
+      `No instrumentation provider specified. Returning console service...`,
+    );
+    return new ConsoleMonitoringService();
+  }
+
+  return serverMonitoringRegistry.get(provider);
+}

packages/monitoring/api/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@kit/tsconfig/base.json",
+  "compilerOptions": {
+    "tsBuildInfoFile": "node_modules/.cache/tsbuildinfo.json"
+  },
+  "include": ["*.ts", "src"],
+  "exclude": ["node_modules"]
+}

packages/monitoring/baselime/README.md

@@ -0,0 +1,3 @@
+# Baselime Monitoring / @kit/baselime
+
+Please refer to the [documentation](https://makerkit.dev/docs/next-supabase-turbo/baselime).

packages/monitoring/baselime/eslint.config.mjs

@@ -0,0 +1,3 @@
+import eslintConfigBase from '@kit/eslint-config/base.js';
+
+export default eslintConfigBase;

packages/monitoring/baselime/node_modules/.bin/acorn

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/bin/acorn" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/bin/acorn" "$@"
+fi

packages/monitoring/baselime/node_modules/.bin/tsc

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/tsc" "$@"
+fi

packages/monitoring/baselime/node_modules/.bin/tsserver

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/typescript@5.8.3/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/typescript@5.8.3/node_modules/typescript/bin/tsserver" "$@"
+fi

packages/monitoring/baselime/node_modules/@baselime/node-opentelemetry

@@ -0,0 +1 @@
+../../../../../node_modules/.pnpm/@baselime+node-opentelemetry@0.5.8_@trpc+server@11.3.1_typescript@5.8.3_/node_modules/@baselime/node-opentelemetry

packages/monitoring/baselime/node_modules/@baselime/react-rum

@@ -0,0 +1 @@
+../../../../../node_modules/.pnpm/@baselime+react-rum@0.3.1_react@19.1.0/node_modules/@baselime/react-rum

packages/monitoring/baselime/node_modules/@kit/eslint-config

@@ -0,0 +1 @@
+../../../../../tooling/eslint

packages/monitoring/baselime/node_modules/@kit/monitoring-core

@@ -0,0 +1 @@
+../../../core

packages/monitoring/baselime/node_modules/@kit/prettier-config

@@ -0,0 +1 @@
+../../../../../tooling/prettier

packages/monitoring/baselime/node_modules/@kit/tsconfig

@@ -0,0 +1 @@
+../../../../../tooling/typescript

packages/monitoring/baselime/node_modules/@types/react

@@ -0,0 +1 @@
+../../../../../node_modules/.pnpm/@types+react@19.1.4/node_modules/@types/react

packages/monitoring/baselime/node_modules/react

@@ -0,0 +1 @@
+../../../../node_modules/.pnpm/react@19.1.0/node_modules/react

packages/monitoring/baselime/node_modules/zod

@@ -0,0 +1 @@
+../../../../node_modules/.pnpm/zod@3.25.56/node_modules/zod

packages/monitoring/baselime/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@kit/baselime",
+  "private": true,
+  "version": "0.1.0",
+  "scripts": {
+    "clean": "git clean -xdf .turbo node_modules",
+    "format": "prettier --check \"**/*.{ts,tsx}\"",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit"
+  },
+  "prettier": "@kit/prettier-config",
+  "exports": {
+    "./server": "./src/server.ts",
+    "./client": "./src/client.ts",
+    "./instrumentation": "./src/instrumentation.ts",
+    "./provider": "./src/components/provider.tsx"
+  },
+  "dependencies": {
+    "@baselime/node-opentelemetry": "^0.5.8",
+    "@baselime/react-rum": "^0.3.1",
+    "@kit/monitoring-core": "workspace:*"
+  },
+  "devDependencies": {
+    "@kit/eslint-config": "workspace:*",
+    "@kit/prettier-config": "workspace:*",
+    "@kit/tsconfig": "workspace:*",
+    "@types/react": "19.1.4",
+    "react": "19.1.0",
+    "zod": "^3.24.4"
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "src/*"
+      ]
+    }
+  }
+}

packages/monitoring/baselime/src/client.ts

@@ -0,0 +1 @@
+export * from './hooks/use-baselime';

packages/monitoring/baselime/src/components/provider.tsx

@@ -0,0 +1,50 @@
+import { useRef } from 'react';
+
+import { BaselimeRum } from '@baselime/react-rum';
+
+import { MonitoringContext } from '@kit/monitoring-core';
+
+import { useBaselime } from '../hooks/use-baselime';
+
+export function BaselimeProvider({
+  children,
+  apiKey,
+  enableWebVitals,
+  ErrorPage,
+}: React.PropsWithChildren<{
+  apiKey?: string;
+  enableWebVitals?: boolean;
+  ErrorPage?: React.ReactElement;
+}>) {
+  const key = apiKey ?? process.env.NEXT_PUBLIC_BASELIME_KEY ?? '';
+
+  if (!key) {
+    console.warn(
+      'You configured Baselime as monitoring provider but did not provide a key. ' +
+        'Please provide a key to enable monitoring with Baselime using the variable NEXT_PUBLIC_BASELIME_KEY.',
+    );
+
+    return children;
+  }
+
+  return (
+    <BaselimeRum
+      apiKey={key}
+      enableWebVitals={enableWebVitals}
+      fallback={ErrorPage ?? null}
+    >
+      <MonitoringProvider>{children}</MonitoringProvider>
+    </BaselimeRum>
+  );
+}
+
+function MonitoringProvider(props: React.PropsWithChildren) {
+  const service = useBaselime();
+  const provider = useRef(service);
+
+  return (
+    <MonitoringContext.Provider value={provider.current}>
+      {props.children}
+    </MonitoringContext.Provider>
+  );
+}

packages/monitoring/baselime/src/hooks/use-baselime.ts

@@ -0,0 +1,30 @@
+import { useMemo } from 'react';
+
+import { useBaselimeRum } from '@baselime/react-rum';
+
+import { MonitoringService } from '@kit/monitoring-core';
+
+/**
+ * @name useBaselime
+ * @description Get the Baselime monitoring service for the browser.
+ */
+export function useBaselime(): MonitoringService {
+  const { captureException, setUser, sendEvent } = useBaselimeRum();
+
+  return useMemo(() => {
+    return {
+      captureException(error: Error, extra?: React.ErrorInfo) {
+        void captureException(error, extra);
+      },
+      identifyUser(params) {
+        setUser(params.id);
+      },
+      captureEvent<Extra extends object>(event: string, extra?: Extra) {
+        return sendEvent(event, extra);
+      },
+      ready() {
+        return Promise.resolve();
+      },
+    } satisfies MonitoringService;
+  }, [captureException, sendEvent, setUser]);
+}

packages/monitoring/baselime/src/instrumentation.ts

@@ -0,0 +1,38 @@
+/**
+ * @name registerInstrumentation
+ * @description This file is used to register Baselime instrumentation for your Next.js application.
+ *
+ * Please set the MONITORING_PROVIDER environment variable to 'baselime' to register Baselime instrumentation.
+ */
+export async function registerInstrumentation() {
+  if (process.env.ENABLE_MONITORING_INSTRUMENTATION !== 'true') {
+    return;
+  }
+
+  const serviceName = process.env.INSTRUMENTATION_SERVICE_NAME;
+
+  if (!serviceName) {
+    throw new Error(`
+      You have set the Baselime instrumentation provider, but have not set the INSTRUMENTATION_SERVICE_NAME environment variable. 
+      Please set the INSTRUMENTATION_SERVICE_NAME environment variable.
+    `);
+  }
+
+  if (process.env.NEXT_RUNTIME === 'nodejs') {
+    const { BaselimeSDK, BetterHttpInstrumentation, VercelPlugin } =
+      await import('@baselime/node-opentelemetry');
+
+    const sdk = new BaselimeSDK({
+      serverless: true,
+      service: serviceName,
+      baselimeKey: process.env.NEXT_PUBLIC_BASELIME_KEY,
+      instrumentations: [
+        new BetterHttpInstrumentation({
+          plugins: [new VercelPlugin()],
+        }),
+      ],
+    });
+
+    sdk.start();
+  }
+}

packages/monitoring/baselime/src/server.ts

@@ -0,0 +1 @@
+export * from './services/baselime-server-monitoring.service';

packages/monitoring/baselime/src/services/baselime-server-monitoring.service.ts

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+
+import { MonitoringService } from '@kit/monitoring-core';
+
+const apiKey = z
+  .string({
+    required_error: 'NEXT_PUBLIC_BASELIME_KEY is required',
+    description: 'The Baseline API key',
+  })
+  .parse(process.env.NEXT_PUBLIC_BASELIME_KEY);
+
+export class BaselimeServerMonitoringService implements MonitoringService {
+  userId: string | null = null;
+
+  async captureException(
+    error: Error | null,
+    extra?: {
+      requestId?: string;
+      sessionId?: string;
+      namespace?: string;
+      service?: string;
+    },
+  ) {
+    const formattedError = error ? getFormattedError(error) : {};
+
+    const event = {
+      level: 'error',
+      data: { error },
+      error: {
+        ...formattedError,
+      },
+      message: error ? `${error.name}: ${error.message}` : `Unknown error`,
+    };
+
+    const response = await fetch(`https://events.baselime.io/v1/logs`, {
+      method: 'POST',
+      headers: {
+        contentType: 'application/json',
+        'x-api-key': apiKey,
+        'x-service': extra?.service ?? '',
+        'x-namespace': extra?.namespace ?? '',
+      },
+      body: JSON.stringify([
+        {
+          userId: this.userId,
+          sessionId: extra?.sessionId,
+          namespace: extra?.namespace,
+          ...event,
+        },
+      ]),
+    });
+
+    if (!response.ok) {
+      console.error(
+        {
+          response,
+          event,
+        },
+        'Failed to send event to Baselime',
+      );
+    }
+  }
+
+  async captureEvent<
+    Extra extends {
+      sessionId?: string;
+      namespace?: string;
+      service?: string;
+    },
+  >(event: string, extra?: Extra) {
+    const response = await fetch(`https://events.baselime.io/v1/logs`, {
+      method: 'POST',
+      headers: {
+        contentType: 'application/json',
+        'x-api-key': apiKey,
+        'x-service': extra?.service ?? '',
+        'x-namespace': extra?.namespace ?? '',
+      },
+      body: JSON.stringify([
+        {
+          userId: this.userId,
+          sessionId: extra?.sessionId,
+          namespace: extra?.namespace,
+          message: event,
+        },
+      ]),
+    });
+
+    if (!response.ok) {
+      console.error(
+        {
+          response,
+          event,
+        },
+        'Failed to send event to Baselime',
+      );
+    }
+  }
+
+  identifyUser<Info extends { id: string }>(info: Info) {
+    this.userId = info.id;
+  }
+
+  ready() {
+    return Promise.resolve();
+  }
+}
+
+function getFormattedError(error: Error) {
+  return {
+    name: error.name,
+    message: error.message,
+    stack: error.stack,
+  };
+}

packages/monitoring/baselime/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@kit/tsconfig/base.json",
+  "compilerOptions": {
+    "tsBuildInfoFile": "node_modules/.cache/tsbuildinfo.json"
+  },
+  "include": ["*.ts", "src"],
+  "exclude": ["node_modules"]
+}

packages/monitoring/core/eslint.config.mjs

@@ -0,0 +1,3 @@
+import eslintConfigBase from '@kit/eslint-config/base.js';
+
+export default eslintConfigBase;

packages/monitoring/core/node_modules/@kit/eslint-config

@@ -0,0 +1 @@
+../../../../../tooling/eslint

packages/monitoring/core/node_modules/@kit/prettier-config

@@ -0,0 +1 @@
+../../../../../tooling/prettier

packages/monitoring/core/node_modules/@kit/tsconfig

@@ -0,0 +1 @@
+../../../../../tooling/typescript

packages/monitoring/core/node_modules/@types/react

@@ -0,0 +1 @@
+../../../../../node_modules/.pnpm/@types+react@19.1.4/node_modules/@types/react

packages/monitoring/core/node_modules/react

@@ -0,0 +1 @@
+../../../../node_modules/.pnpm/react@19.1.0/node_modules/react

packages/monitoring/core/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@kit/monitoring-core",
+  "private": true,
+  "sideEffects": false,
+  "version": "0.1.0",
+  "scripts": {
+    "clean": "git clean -xdf .turbo node_modules",
+    "format": "prettier --check \"**/*.{ts,tsx}\"",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit"
+  },
+  "prettier": "@kit/prettier-config",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "devDependencies": {
+    "@kit/eslint-config": "workspace:*",
+    "@kit/prettier-config": "workspace:*",
+    "@kit/tsconfig": "workspace:*",
+    "@types/react": "19.1.4",
+    "react": "19.1.0"
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "src/*"
+      ]
+    }
+  }
+}

packages/monitoring/core/src/console-monitoring.service.ts

@@ -0,0 +1,21 @@
+import { MonitoringService } from '@kit/monitoring-core';
+
+export class ConsoleMonitoringService implements MonitoringService {
+  identifyUser(data: { id: string }) {
+    console.log(`[Console Monitoring] Identified user`, data);
+  }
+
+  captureException(error: Error) {
+    console.error(
+      `[Console Monitoring] Caught exception: ${JSON.stringify(error)}`,
+    );
+  }
+
+  captureEvent(event: string) {
+    console.log(`[Console Monitoring] Captured event: ${event}`);
+  }
+
+  ready() {
+    return Promise.resolve();
+  }
+}

packages/monitoring/core/src/index.ts

@@ -0,0 +1,3 @@
+export * from './monitoring.service';
+export * from './monitoring.context';
+export * from './console-monitoring.service';

packages/monitoring/core/src/monitoring.context.ts

@@ -0,0 +1,10 @@
+'use client';
+
+import { createContext } from 'react';
+
+import { ConsoleMonitoringService } from './console-monitoring.service';
+import { MonitoringService } from './monitoring.service';
+
+export const MonitoringContext = createContext<MonitoringService>(
+  new ConsoleMonitoringService(),
+);

packages/monitoring/core/src/monitoring.service.ts

@@ -0,0 +1,37 @@
+/**
+ * Monitoring service interface
+ * @description This service is used to capture exceptions and identify users in the monitoring service
+ * @example
+ */
+export abstract class MonitoringService {
+  /**
+   * Capture an exception
+   * @param error
+   * @param extra
+   */
+  abstract captureException<Extra extends object>(
+    error: Error & { digest?: string },
+    extra?: Extra,
+  ): unknown;
+
+  /**
+   * Track an event
+   * @param event
+   * @param extra
+   */
+  abstract captureEvent<Extra extends object>(
+    event: string,
+    extra?: Extra,
+  ): unknown;
+
+  /**
+   * Identify a user in the monitoring service - used for tracking user actions
+   * @param info
+   */
+  abstract identifyUser<Info extends { id: string }>(info: Info): unknown;
+
+  /**
+   * Wait for the monitoring service to be ready
+   */
+  abstract ready(): Promise<unknown>;
+}

packages/monitoring/core/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@kit/tsconfig/base.json",
+  "compilerOptions": {
+    "tsBuildInfoFile": "node_modules/.cache/tsbuildinfo.json"
+  },
+  "include": ["*.ts", "src"],
+  "exclude": ["node_modules"]
+}

packages/monitoring/sentry/README.md

@@ -0,0 +1,3 @@
+# Sentry Monitoring / @kit/sentry
+
+Please refer to the [documentation](https://makerkit.dev/docs/next-supabase-turbo/sentry).

packages/monitoring/sentry/eslint.config.mjs

@@ -0,0 +1,3 @@
+import eslintConfigBase from '@kit/eslint-config/base.js';
+
+export default eslintConfigBase;

packages/monitoring/sentry/node_modules/.bin/acorn

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/acorn@8.14.1/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/bin/acorn" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/acorn@8.14.1/node_modules/acorn/bin/acorn" "$@"
+fi

packages/monitoring/sentry/node_modules/.bin/browserslist

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/browserslist@4.25.0/node_modules/browserslist/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/browserslist@4.25.0/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/browserslist@4.25.0/node_modules/browserslist/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/browserslist@4.25.0/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/browserslist@4.25.0/node_modules/browserslist/cli.js" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/browserslist@4.25.0/node_modules/browserslist/cli.js" "$@"
+fi

packages/monitoring/sentry/node_modules/.bin/next

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/next@15.3.2_@babel+core@7.27.4_@opentelemetry+api@1.9.0_babel-plugin-react-compiler@19.1.0-rc_krzs4il3c2axvegn27goximifi/node_modules/next/dist/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/next@15.3.2_@babel+core@7.27.4_@opentelemetry+api@1.9.0_babel-plugin-react-compiler@19.1.0-rc_krzs4il3c2axvegn27goximifi/node_modules/next/dist/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/next@15.3.2_@babel+core@7.27.4_@opentelemetry+api@1.9.0_babel-plugin-react-compiler@19.1.0-rc_krzs4il3c2axvegn27goximifi/node_modules/next/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/next@15.3.2_@babel+core@7.27.4_@opentelemetry+api@1.9.0_babel-plugin-react-compiler@19.1.0-rc_krzs4il3c2axvegn27goximifi/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/next@15.3.2_@babel+core@7.27.4_@opentelemetry+api@1.9.0_babel-plugin-react-compiler@19.1.0-rc_krzs4il3c2axvegn27goximifi/node_modules/next/dist/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/next@15.3.2_@babel+core@7.27.4_@opentelemetry+api@1.9.0_babel-plugin-react-compiler@19.1.0-rc_krzs4il3c2axvegn27goximifi/node_modules/next/dist/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/next@15.3.2_@babel+core@7.27.4_@opentelemetry+api@1.9.0_babel-plugin-react-compiler@19.1.0-rc_krzs4il3c2axvegn27goximifi/node_modules/next/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/next@15.3.2_@babel+core@7.27.4_@opentelemetry+api@1.9.0_babel-plugin-react-compiler@19.1.0-rc_krzs4il3c2axvegn27goximifi/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/next@15.3.2_@babel+core@7.27.4_@opentelemetry+api@1.9.0_babel-plugin-react-compiler@19.1.0-rc_krzs4il3c2axvegn27goximifi/node_modules/next/dist/bin/next" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/next@15.3.2_@babel+core@7.27.4_@opentelemetry+api@1.9.0_babel-plugin-react-compiler@19.1.0-rc_krzs4il3c2axvegn27goximifi/node_modules/next/dist/bin/next" "$@"
+fi

packages/monitoring/sentry/node_modules/.bin/rollup

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/rollup@4.35.0/node_modules/rollup/dist/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/rollup@4.35.0/node_modules/rollup/dist/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/rollup@4.35.0/node_modules/rollup/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/rollup@4.35.0/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/rollup@4.35.0/node_modules/rollup/dist/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/rollup@4.35.0/node_modules/rollup/dist/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/rollup@4.35.0/node_modules/rollup/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/rollup@4.35.0/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/rollup@4.35.0/node_modules/rollup/dist/bin/rollup" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/rollup@4.35.0/node_modules/rollup/dist/bin/rollup" "$@"
+fi

packages/monitoring/sentry/node_modules/.bin/webpack

@@ -0,0 +1,17 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*) basedir=`cygpath -w "$basedir"`;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/webpack@5.99.9/node_modules/webpack/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/webpack@5.99.9/node_modules/webpack/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/webpack@5.99.9/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/webpack@5.99.9/node_modules/webpack/bin/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/webpack@5.99.9/node_modules/webpack/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/webpack@5.99.9/node_modules:/Users/devmcee/dev/mountbirch/MRB2B/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../../node_modules/.pnpm/webpack@5.99.9/node_modules/webpack/bin/webpack.js" "$@"
+else
+  exec node  "$basedir/../../../../../node_modules/.pnpm/webpack@5.99.9/node_modules/webpack/bin/webpack.js" "$@"
+fi

packages/monitoring/sentry/node_modules/@kit/eslint-config

@@ -0,0 +1 @@
+../../../../../tooling/eslint

packages/monitoring/sentry/node_modules/@kit/monitoring-core

@@ -0,0 +1 @@
+../../../core

packages/monitoring/sentry/node_modules/@kit/prettier-config

@@ -0,0 +1 @@
+../../../../../tooling/prettier

packages/monitoring/sentry/node_modules/@kit/tsconfig

@@ -0,0 +1 @@
+../../../../../tooling/typescript

packages/monitoring/sentry/node_modules/@sentry/nextjs

@@ -0,0 +1 @@
+../../../../../node_modules/.pnpm/@sentry+nextjs@9.27.0_@opentelemetry+context-async-hooks@1.30.1_@opentelemetry+api@1.9.0__@op_t5jxdwm6lg44gx7av6vdt276cy/node_modules/@sentry/nextjs

packages/monitoring/sentry/node_modules/@types/react

@@ -0,0 +1 @@
+../../../../../node_modules/.pnpm/@types+react@19.1.4/node_modules/@types/react

packages/monitoring/sentry/node_modules/import-in-the-middle

@@ -0,0 +1 @@
+../../../../node_modules/.pnpm/import-in-the-middle@1.13.2/node_modules/import-in-the-middle

packages/monitoring/sentry/node_modules/react

@@ -0,0 +1 @@
+../../../../node_modules/.pnpm/react@19.1.0/node_modules/react

packages/monitoring/sentry/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@kit/sentry",
+  "private": true,
+  "version": "0.1.0",
+  "scripts": {
+    "clean": "git clean -xdf .turbo node_modules",
+    "format": "prettier --check \"**/*.{ts,tsx}\"",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit"
+  },
+  "prettier": "@kit/prettier-config",
+  "exports": {
+    ".": "./src/index.ts",
+    "./provider": "./src/components/provider.tsx",
+    "./config/client": "./src/sentry.client.config.ts",
+    "./config/server": "./src/sentry.client.server.ts"
+  },
+  "dependencies": {
+    "@sentry/nextjs": "^9.19.0",
+    "import-in-the-middle": "1.13.2"
+  },
+  "devDependencies": {
+    "@kit/eslint-config": "workspace:*",
+    "@kit/monitoring-core": "workspace:*",
+    "@kit/prettier-config": "workspace:*",
+    "@kit/tsconfig": "workspace:*",
+    "@types/react": "19.1.4",
+    "react": "19.1.0"
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "src/*"
+      ]
+    }
+  }
+}

packages/monitoring/sentry/src/components/provider.tsx

@@ -0,0 +1,17 @@
+import { MonitoringContext } from '@kit/monitoring-core';
+
+import { SentryMonitoringService } from '../services/sentry-monitoring.service';
+
+const sentry = new SentryMonitoringService();
+
+export function SentryProvider({ children }: React.PropsWithChildren) {
+  return <MonitoringProvider>{children}</MonitoringProvider>;
+}
+
+function MonitoringProvider(props: React.PropsWithChildren) {
+  return (
+    <MonitoringContext.Provider value={sentry}>
+      {props.children}
+    </MonitoringContext.Provider>
+  );
+}

packages/monitoring/sentry/src/index.ts

@@ -0,0 +1 @@
+export * from './services/sentry-monitoring.service';

packages/monitoring/sentry/src/sentry.client.config.ts

@@ -0,0 +1,42 @@
+import { init } from '@sentry/nextjs';
+
+type Parameters<T extends (args: never) => unknown> = T extends (
+  ...args: infer P
+) => unknown
+  ? P
+  : never;
+
+/**
+ * @name initializeSentryBrowserClient
+ * @description Initialize the Sentry client
+ * @param props
+ */
+export function initializeSentryBrowserClient(
+  props: Parameters<typeof init>[0] = {},
+) {
+  return init({
+    dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
+    // Replay may only be enabled for the client-side
+    integrations: [
+      // add your desired integrations here
+      // https://docs.sentry.io/platforms/javascript/configuration/integrations/
+    ],
+
+    // Set tracesSampleRate to 1.0 to capture 100%
+    // of transactions for performance monitoring.
+    // We recommend adjusting this value in production
+    tracesSampleRate: props?.tracesSampleRate ?? 1.0,
+
+    // Capture Replay for 10% of all sessions,
+    // plus for 100% of sessions with an error
+    replaysSessionSampleRate: 0.1,
+    replaysOnErrorSampleRate: 1.0,
+
+    // ...
+
+    // Note: if you want to override the automatic release value, do not set a
+    // `release` value here - use the environment variable `SENTRY_RELEASE`, so
+    // that it will also get attached to your source maps,
+    ...props,
+  });
+}

packages/monitoring/sentry/src/sentry.server.config.ts

@@ -0,0 +1,27 @@
+import { init } from '@sentry/nextjs';
+
+type Parameters<T extends (args: never) => unknown> = T extends (
+  ...args: infer P
+) => unknown
+  ? P
+  : never;
+
+/**
+ * @name initializeSentryServerClient
+ * @description Initialize the Sentry client in the server
+ * @param props
+ */
+export function initializeSentryServerClient(
+  props: Parameters<typeof init>[0] = {},
+) {
+  return init({
+    dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
+
+    // ...
+
+    // Note: if you want to override the automatic release value, do not set a
+    // `release` value here - use the environment variable `SENTRY_RELEASE`, so
+    // that it will also get attached to your source maps,
+    ...props,
+  });
+}

packages/monitoring/sentry/src/services/sentry-monitoring.service.ts

@@ -0,0 +1,71 @@
+import {
+  Event as SentryEvent,
+  User as SentryUser,
+  captureEvent,
+  captureException,
+  setUser,
+} from '@sentry/nextjs';
+
+import { MonitoringService } from '@kit/monitoring-core';
+
+/**
+ * @class
+ * @implements {MonitoringService}
+ * ServerSentryMonitoringService is responsible for capturing exceptions and identifying users using the Sentry monitoring service.
+ */
+export class SentryMonitoringService implements MonitoringService {
+  private readonly readyPromise: Promise<unknown>;
+  private readyResolver?: (value?: unknown) => void;
+
+  constructor() {
+    this.readyPromise = new Promise(
+      (resolve) => (this.readyResolver = resolve),
+    );
+
+    void this.initialize();
+  }
+
+  async ready() {
+    return this.readyPromise;
+  }
+
+  captureException(error: Error | null) {
+    return captureException(error);
+  }
+
+  captureEvent<Extra extends SentryEvent>(event: string, extra?: Extra) {
+    return captureEvent({
+      message: event,
+      ...(extra ?? {}),
+    });
+  }
+
+  identifyUser(user: SentryUser) {
+    setUser(user);
+  }
+
+  private async initialize() {
+    const environment =
+      process.env.NEXT_PUBLIC_SENTRY_ENVIRONMENT ?? process.env.VERCEL_ENV;
+
+    if (typeof document !== 'undefined') {
+      const { initializeSentryBrowserClient } = await import(
+        '../sentry.client.config'
+      );
+
+      initializeSentryBrowserClient({
+        environment,
+      });
+    } else {
+      const { initializeSentryServerClient } = await import(
+        '../sentry.server.config'
+      );
+
+      initializeSentryServerClient({
+        environment,
+      });
+    }
+
+    this.readyResolver?.();
+  }
+}

packages/monitoring/sentry/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "@kit/tsconfig/base.json",
+  "compilerOptions": {
+    "tsBuildInfoFile": "node_modules/.cache/tsbuildinfo.json"
+  },
+  "include": ["*.ts", "src"],
+  "exclude": ["node_modules"]
+}