Add Turborepo configuration and scripts for improved monorepo management

.github/workflows/algolia-index.yml

@@ -36,11 +36,23 @@ jobs:
       - run: yarn install --frozen-lockfile
         if: steps.cache.outputs.cache-hit != 'true'
 
+      # Setup Turbo cache with better cache keys for builds
+      - name: Setup Turbo cache
+        uses: actions/cache@v4
+        with:
+          path: .turbo
+          key: ${{ runner.os }}-turbo-algolia-${{ hashFiles('**/package.json', '**/turbo.json', '**/next.config.*', '**/tsconfig.json', 'docs/**', 'includes/**', 'platform-includes/**', 'develop-docs/**') }}-${{ github.sha }}
+          restore-keys: |
+            ${{ runner.os }}-turbo-algolia-${{ hashFiles('**/package.json', '**/turbo.json', '**/next.config.*', '**/tsconfig.json') }}-
+            ${{ runner.os }}-turbo-algolia-
+            ${{ runner.os }}-turbo-build-
+            ${{ runner.os }}-turbo-
+
       # bun seems to be the most straightforward way to run a TypeScript script
       # without introducing another dependency like ts-node or tsx for everyone else
 
       - name: Build index for user docs
-        run: yarn build && bun ./scripts/algolia.ts
+        run: yarn turbo run build && bun ./scripts/algolia.ts
         if: steps.filter.outputs.docs == 'true'
         env:
           ALGOLIA_APP_ID: ${{ secrets.ALGOLIA_APP_ID }}
@@ -52,7 +64,7 @@ jobs:
           NEXT_PUBLIC_SENTRY_DSN: https://[email protected]/0
 
       - name: Build index for developer docs
-        run: yarn build:developer-docs && bun ./scripts/algolia.ts
+        run: yarn turbo run build:developer-docs && bun ./scripts/algolia.ts
         if: steps.filter.outputs.dev-docs == 'true'
         env:
           ALGOLIA_APP_ID: ${{ secrets.ALGOLIA_APP_ID }}

.github/workflows/lint-404s.yml

@@ -38,13 +38,24 @@ jobs:
       - run: yarn install --frozen-lockfile
         if: steps.cache.outputs.cache-hit != 'true'
 
-      - run: yarn build
+      # Setup Turbo cache with better cache keys for builds
+      - name: Setup Turbo cache
+        uses: actions/cache@v4
+        with:
+          path: .turbo
+          key: ${{ runner.os }}-turbo-build-${{ hashFiles('**/package.json', '**/turbo.json', '**/next.config.*', '**/tsconfig.json', 'docs/**', 'includes/**', 'platform-includes/**', 'develop-docs/**') }}-${{ github.sha }}
+          restore-keys: |
+            ${{ runner.os }}-turbo-build-${{ hashFiles('**/package.json', '**/turbo.json', '**/next.config.*', '**/tsconfig.json') }}-
+            ${{ runner.os }}-turbo-build-
+            ${{ runner.os }}-turbo-
+
+      - run: yarn turbo run build
         if: steps.filter.outputs.docs == 'true'
         env:
           SENTRY_DSN: https://[email protected]/0
           NEXT_PUBLIC_SENTRY_DSN: https://[email protected]/0
 
-      - run: yarn build:developer-docs
+      - run: yarn turbo run build:developer-docs
         if: steps.filter.outputs.dev-docs == 'true'
         env:
           SENTRY_DSN: https://[email protected]/0

.github/workflows/test.yml

@@ -31,16 +31,28 @@ jobs:
         with:
           path: ${{ github.workspace }}/node_modules
           key: node-${{ runner.os }}-${{ hashFiles('**/yarn.lock') }}
+
       - run: yarn install --frozen-lockfile
         if: steps.cache.outputs.cache-hit != 'true'
 
-      # Additional checks
-      - run: yarn lint:ts
-      - run: yarn lint:docs
+      # Setup Turbo cache with better cache keys
+      - name: Setup Turbo cache
+        uses: actions/cache@v4
+        with:
+          path: .turbo
+          key: ${{ runner.os }}-turbo-lint-${{ hashFiles('**/package.json', '**/turbo.json', '**/.eslintrc*', '**/tsconfig.json') }}-${{ github.sha }}
+          restore-keys: |
+            ${{ runner.os }}-turbo-lint-${{ hashFiles('**/package.json', '**/turbo.json', '**/.eslintrc*', '**/tsconfig.json') }}-
+            ${{ runner.os }}-turbo-lint-
+            ${{ runner.os }}-turbo-
+
+      # Additional checks using Turbo
+      - run: yarn turbo run lint:ts
+      - run: yarn turbo run lint:docs
 
-      # Run automatic fixes (run prettier apart from eslint to also fix mdx files)
-      - run: yarn lint:prettier:fix
-      - run: yarn lint:eslint:fix
+      # Run automatic fixes using Turbo (run prettier apart from eslint to also fix mdx files)
+      - run: yarn turbo run lint:prettier:fix
+      - run: yarn turbo run lint:eslint:fix
 
       # Check (and error) for dirty working tree for forks
       # Reason being we need a different token to auto commit changes and
@@ -73,5 +85,17 @@ jobs:
           key: node-${{ runner.os }}-${{ hashFiles('**/yarn.lock') }}
       - run: yarn install --frozen-lockfile
         if: steps.cache.outputs.cache-hit != 'true'
+
+      # Setup Turbo cache with better cache keys
+      - name: Setup Turbo cache
+        uses: actions/cache@v4
+        with:
+          path: .turbo
+          key: ${{ runner.os }}-turbo-test-${{ hashFiles('**/package.json', '**/turbo.json', '**/*.{ts,tsx,js,jsx}', '**/tsconfig.json') }}-${{ github.sha }}
+          restore-keys: |
+            ${{ runner.os }}-turbo-test-${{ hashFiles('**/package.json', '**/turbo.json', '**/*.{ts,tsx,js,jsx}', '**/tsconfig.json') }}-
+            ${{ runner.os }}-turbo-test-
+            ${{ runner.os }}-turbo-
+
       - name: Run Tests
-        run: yarn test
+        run: yarn turbo run test

.gitignore

@@ -98,3 +98,7 @@ public/mdx-images/*
 # yalc
 .yalc
 yalc.lock
+
+# turborepo
+.turbo
+.turborc

apps/changelog/package.json

@@ -7,6 +7,7 @@
   "author": "getsentry",
   "license": "FSL-1.1-Apache-2.0",
   "private": true,
+  "packageManager": "[email protected]",
   "scripts": {
     "dev": "next dev",
     "build": "prisma generate && next build",
@@ -65,7 +66,9 @@
     "extends": "../../package.json"
   },
   "resolutions": {
-    "@types/react": "npm:[email protected]",
-    "@types/react-dom": "npm:[email protected]"
+    "@sentry/core": "9.27.0",
+    "@sentry/types": "9.27.0",
+    "@sentry/nextjs": "9.27.0",
+    "@sentry/node": "9.27.0"
   }
 }

apps/changelog/src/instrumentation-client.ts

@@ -1,4 +1,3 @@
-import * as SentryCore from '@sentry/core';
 import * as Sentry from '@sentry/nextjs';
 import * as Spotlight from '@spotlightjs/spotlight';
 
@@ -10,7 +9,7 @@ Sentry.init({
   replaysSessionSampleRate: 0.1,
   integrations: [
     Sentry.replayIntegration(),
-    SentryCore.thirdPartyErrorFilterIntegration({
+    Sentry.thirdPartyErrorFilterIntegration({
       filterKeys: ['sentry-changelog'],
       behaviour: 'apply-tag-if-contains-third-party-frames',
     }),

package.json

@@ -11,6 +11,7 @@
     "url": "https://github.com/getsentry/sentry-docs/issues"
   },
   "private": true,
+  "packageManager": "[email protected]",
   "workspaces": [
     "./apps/*"
   ],
@@ -32,7 +33,11 @@
     "sidecar": "yarn spotlight-sidecar",
     "test": "vitest",
     "test:ci": "vitest run",
-    "enforce-redirects": "node ./scripts/no-vercel-json-redirects.mjs"
+    "enforce-redirects": "node ./scripts/no-vercel-json-redirects.mjs",
+    "turbo:dev": "turbo run dev",
+    "turbo:build": "turbo run build",
+    "turbo:lint": "turbo run lint",
+    "turbo:test": "turbo run test"
   },
   "dependencies": {
     "@ariakit/react": "^0.4.5",
@@ -124,12 +129,17 @@
     "prettier": "^3.2.4",
     "tailwindcss": "^3.4.1",
     "ts-node": "^10.9.1",
+    "turbo": "^2.5.4",
     "typescript": "^5",
     "vite-tsconfig-paths": "^5.0.1",
     "vitest": "^3.0.7",
     "ws": "^8.17.1"
   },
   "resolutions": {
+    "@sentry/core": "9.27.0",
+    "@sentry/types": "9.27.0",
+    "@sentry/nextjs": "9.27.0",
+    "@sentry/node": "9.27.0",
     "dompurify": "3.2.4",
     "@types/dompurify": "3.0.5"
   },

src/instrumentation-client.ts

@@ -33,6 +33,9 @@ Sentry.init({
   ],
 });
 
+// Required for navigation instrumentation
+export const onRouterTransitionStart = Sentry.captureRouterTransitionStart;
+
 if (process.env.NODE_ENV === 'development') {
   Spotlight.init({
     showClearEventsButton: true,

turbo.json

@@ -0,0 +1,183 @@
+{
+    "$schema": "https://turbo.build/schema.json",
+    "tasks": {
+        "build": {
+            "dependsOn": [
+                "^build"
+            ],
+            "outputs": [
+                ".next/**",
+                "!.next/cache/**",
+                "dist/**"
+            ],
+            "env": [
+                "NODE_ENV",
+                "NEXT_PUBLIC_*",
+                "SENTRY_DSN",
+                "CI",
+                "CODECOV_TOKEN",
+                "VERCEL_URL",
+                "OPENAPI_LOCAL_PATH",
+                "GATSBY_ENV",
+                "GATSBY_HIDE_SANDBOX",
+                "ESBUILD_BINARY_PATH",
+                "ALGOLIA_APP_ID",
+                "ALGOLIA_API_KEY",
+                "DOCS_INDEX_NAME",
+                "DEVELOP_DOCS_INDEX_NAME",
+                "ALOGOLIA_SKIP_ON_ERROR",
+                "GOOGLE_CLIENT_ID",
+                "GOOGLE_CLIENT_SECRET",
+                "GOOGLE_PROJECT_ID",
+                "GOOGLE_CLIENT_EMAIL",
+                "GOOGLE_PRIVATE_KEY",
+                "GOOGLE_BUCKET_NAME"
+            ]
+        },
+        "build:developer-docs": {
+            "dependsOn": [
+                "^build"
+            ],
+            "outputs": [
+                ".next/**",
+                "!.next/cache/**",
+                "dist/**"
+            ],
+            "env": [
+                "NODE_ENV",
+                "NEXT_PUBLIC_*",
+                "SENTRY_DSN",
+                "CI",
+                "CODECOV_TOKEN",
+                "VERCEL_URL",
+                "OPENAPI_LOCAL_PATH",
+                "GATSBY_ENV",
+                "GATSBY_HIDE_SANDBOX",
+                "ESBUILD_BINARY_PATH",
+                "ALGOLIA_APP_ID",
+                "ALGOLIA_API_KEY",
+                "DOCS_INDEX_NAME",
+                "DEVELOP_DOCS_INDEX_NAME",
+                "ALOGOLIA_SKIP_ON_ERROR",
+                "GOOGLE_CLIENT_ID",
+                "GOOGLE_CLIENT_SECRET",
+                "GOOGLE_PROJECT_ID",
+                "GOOGLE_CLIENT_EMAIL",
+                "GOOGLE_PRIVATE_KEY",
+                "GOOGLE_BUCKET_NAME"
+            ]
+        },
+        "dev": {
+            "cache": false,
+            "persistent": true,
+            "env": [
+                "NODE_ENV",
+                "NEXT_PUBLIC_*",
+                "SENTRY_DSN",
+                "VERCEL_URL",
+                "OPENAPI_LOCAL_PATH",
+                "GATSBY_ENV",
+                "GATSBY_HIDE_SANDBOX",
+                "GOOGLE_CLIENT_ID",
+                "GOOGLE_CLIENT_SECRET",
+                "GOOGLE_PROJECT_ID",
+                "GOOGLE_CLIENT_EMAIL",
+                "GOOGLE_PRIVATE_KEY",
+                "GOOGLE_BUCKET_NAME"
+            ]
+        },
+        "dev:developer-docs": {
+            "cache": false,
+            "persistent": true,
+            "env": [
+                "NODE_ENV",
+                "NEXT_PUBLIC_*",
+                "SENTRY_DSN",
+                "VERCEL_URL",
+                "OPENAPI_LOCAL_PATH",
+                "GATSBY_ENV",
+                "GATSBY_HIDE_SANDBOX",
+                "GOOGLE_CLIENT_ID",
+                "GOOGLE_CLIENT_SECRET",
+                "GOOGLE_PROJECT_ID",
+                "GOOGLE_CLIENT_EMAIL",
+                "GOOGLE_PRIVATE_KEY",
+                "GOOGLE_BUCKET_NAME"
+            ]
+        },
+        "start": {
+            "dependsOn": [
+                "build"
+            ],
+            "cache": false,
+            "persistent": true
+        },
+        "lint": {
+            "outputs": []
+        },
+        "lint:ts": {
+            "outputs": []
+        },
+        "lint:docs": {
+            "outputs": []
+        },
+        "lint:eslint": {
+            "outputs": []
+        },
+        "lint:eslint:fix": {
+            "cache": false,
+            "outputs": []
+        },
+        "lint:prettier": {
+            "outputs": []
+        },
+        "lint:prettier:fix": {
+            "cache": false,
+            "outputs": []
+        },
+        "lint:fix": {
+            "cache": false,
+            "outputs": []
+        },
+        "test": {
+            "dependsOn": [
+                "^build"
+            ],
+            "outputs": [
+                "coverage/**"
+            ],
+            "inputs": [
+                "src/**/*.{ts,tsx,js,jsx}",
+                "test/**/*.{ts,tsx,js,jsx}",
+                "**/*.test.*",
+                "**/*.spec.*"
+            ],
+            "env": [
+                "NODE_ENV"
+            ]
+        },
+        "test:ci": {
+            "dependsOn": [
+                "^build"
+            ],
+            "outputs": [
+                "coverage/**"
+            ],
+            "inputs": [
+                "src/**/*.{ts,tsx,js,jsx}",
+                "test/**/*.{ts,tsx,js,jsx}",
+                "**/*.test.*",
+                "**/*.spec.*"
+            ],
+            "env": [
+                "NODE_ENV"
+            ]
+        },
+        "enforce-redirects": {
+            "cache": false
+        },
+        "migrate:dev": {
+            "cache": false
+        }
+    }
+}