fix: set release in Sentry.init (v10 ignores build option), clean up .map in preview

- Remove release option from sentry() integration (ignored in @sentry/astro v10)
- Set release in Sentry.init() via PUBLIC_SENTRY_RELEASE/SENTRY_RELEASE env vars
- Add .map file cleanup to docs-preview.yml before deploy

Author: BYK

.github/workflows/ci.yml

@@ -691,6 +691,7 @@ jobs:
         env:
           PUBLIC_SENTRY_ENVIRONMENT: production
           SENTRY_RELEASE: ${{ steps.version.outputs.version }}
+          PUBLIC_SENTRY_RELEASE: ${{ steps.version.outputs.version }}
         run: |
           bun install --frozen-lockfile
           bun run build

.github/workflows/docs-preview.yml

@@ -45,6 +45,7 @@ jobs:
           DOCS_BASE_PATH: /pr-preview/pr-${{ github.event.pull_request.number }}
           PUBLIC_SENTRY_ENVIRONMENT: staging
           SENTRY_RELEASE: ${{ steps.version.outputs.version }}
+          PUBLIC_SENTRY_RELEASE: ${{ steps.version.outputs.version }}
         run: |
           bun install --frozen-lockfile
           bun run build
@@ -61,6 +62,10 @@ jobs:
             --release "${{ steps.version.outputs.version }}" \
             --url-prefix "~/"
 
+      # Remove .map files — uploaded to Sentry but shouldn't be deployed.
+      - name: Remove sourcemaps from output
+        run: find docs/dist -name '*.map' -delete
+
       - name: Ensure .nojekyll at gh-pages root
         run: |
           git config user.name "github-actions[bot]"

docs/astro.config.mjs

@@ -5,9 +5,6 @@ import { defineConfig } from "astro/config";
 // Allow base path override via environment variable for PR previews
 const base = process.env.DOCS_BASE_PATH || "/";
 
-// Release name from CI (root package.json version). Undefined in local dev.
-const release = process.env.SENTRY_RELEASE;
-
 export default defineConfig({
   site: "https://cli.sentry.dev",
   base,
@@ -27,7 +24,10 @@ export default defineConfig({
       project: "cli-website",
       org: "sentry",
       environment: process.env.PUBLIC_SENTRY_ENVIRONMENT ?? "development",
-      release: release ? { name: release } : undefined,
+      // Note: @sentry/astro v10 does not support the `release` build-time
+      // option (todo(v11) in the source). Release is set in Sentry.init()
+      // via PUBLIC_SENTRY_RELEASE / SENTRY_RELEASE env vars instead.
+      //
       // Disable the plugin's sourcemap upload — it pulls in @sentry/cli
       // (20+ MB binary download). We use our own CLI post-build instead
       // (see CI workflow: `sentry sourcemap inject` + `sentry sourcemap upload`).

docs/sentry.client.config.js

@@ -3,6 +3,7 @@ import * as Sentry from "@sentry/astro";
 Sentry.init({
   dsn: "https://2aca5fe97c71868bc3aa7fb48620dc39@o1.ingest.us.sentry.io/4510798755856384",
   environment: import.meta.env.PUBLIC_SENTRY_ENVIRONMENT ?? "development",
+  release: import.meta.env.PUBLIC_SENTRY_RELEASE || undefined,
   sendDefaultPii: true,
   integrations: [
     Sentry.browserTracingIntegration(),

docs/sentry.server.config.js

@@ -3,6 +3,7 @@ import * as Sentry from "@sentry/astro";
 Sentry.init({
   dsn: "https://2aca5fe97c71868bc3aa7fb48620dc39@o1.ingest.us.sentry.io/4510798755856384",
   environment: process.env.PUBLIC_SENTRY_ENVIRONMENT ?? "development",
+  release: process.env.SENTRY_RELEASE || undefined,
   sendDefaultPii: true,
   enableLogs: true,
   tracesSampleRate: 1.0,