Skip to content

feat(docs): enable sourcemap upload, releases, and environment tracking#705

Merged
BYK merged 6 commits intomainfrom
feat/docs-sourcemaps
Apr 9, 2026
Merged

feat(docs): enable sourcemap upload, releases, and environment tracking#705
BYK merged 6 commits intomainfrom
feat/docs-sourcemaps

Conversation

@BYK
Copy link
Copy Markdown
Member

@BYK BYK commented Apr 9, 2026

Summary

Enable sourcemap resolution and environment tracking for the docs site (cli.sentry.dev / cli-website Sentry project).

  • Sourcemaps uploaded to Sentry after each docs build using our own CLI (no 20MB @sentry/cli binary)
  • Environment tracking: production on main/release, staging on PR previews, development locally
  • Release names match the CLI version from package.json
  • cli-website project associated with CLI releases in sentry-release.yml

Changes

  • docs/astro.config.mjs: Disable @sentry/astro plugin upload, enable Vite sourcemap generation (hidden), add environment and release
  • docs/sentry.client.config.js: Add environment from PUBLIC_SENTRY_ENVIRONMENT
  • docs/sentry.server.config.js: Add environment from PUBLIC_SENTRY_ENVIRONMENT
  • .github/workflows/ci.yml: Post-build sentry sourcemap inject + upload (push to main/release only)
  • .github/workflows/docs-preview.yml: Same post-build inject+upload for PR previews
  • .github/workflows/sentry-release.yml: Add cli-website to --project in release create

- Disable @sentry/astro's built-in upload (avoids 20MB @sentry/cli binary)
- Use our own CLI post-build: sentry sourcemap inject + upload
- Add environment tracking: production (main/release), staging (PR preview), development (local)
- Add release name from root package.json version
- Associate cli-website project with CLI releases in sentry-release.yml
- Enable Vite sourcemap generation (hidden mode)
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

Semver Impact of This PR

🟡 Minor (new features)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).


New Features ✨

  • (commands) Add buildRouteMap wrapper with standard subcommand aliases by BYK in #690
  • (config) Support .sentryclirc config file for per-directory defaults by BYK in #693
  • (docs) Enable sourcemap upload, releases, and environment tracking by BYK in #705

Bug Fixes 🐛

Dashboard

  • Add --layout flag to widget add for predictable placement by BYK in #700
  • Render tracemetrics widgets in dashboard view by BYK in #695

Other

  • (build) Enable sourcemap resolution for compiled binaries by BYK in #701
  • (init) Narrow command validation to actual shell injection vectors by betegon in #697
  • (init,feedback) Default to tracing only in feature select and attach user email to feedback by MathurAditya724 in #688
  • (setup) Handle read-only .claude directory in sandboxed environments by BYK in #702

Internal Changes 🔧

  • (docs) Gitignore generated command docs, extract fragments by BYK in #696
  • (eval) Replace OpenAI with Anthropic SDK in init-eval judge by betegon in #683
  • (init) Use markdown pipeline for spinner messages by betegon in #686
  • Regenerate skill files and command docs by github-actions[bot] in 584ec0e0

🤖 This preview updates automatically when you update the PR.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

Codecov Results 📊

134 passed | Total: 134 | Pass Rate: 100% | Execution Time: 0ms

📊 Comparison with Base Branch

Metric Change
Total Tests
Passed Tests
Failed Tests
Skipped Tests

✨ No test changes detected

All tests are passing successfully.

✅ Patch coverage is 100.00%. Project has 1564 uncovered lines.
✅ Project coverage is 95.31%. Comparing base (base) to head (head).

Coverage diff
@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
+ Coverage    95.29%    95.31%    +0.02%
==========================================
  Files          229       229         —
  Lines        33377     33378        +1
  Branches         0         0         —
==========================================
+ Hits         31808     31814        +6
- Misses        1569      1564        -5
- Partials         0         0         —

Generated by Codecov Action

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

PR Preview Action v1.8.1

QR code for preview link

🚀 View preview at
https://cli.sentry.dev/pr-preview/pr-705/

Built to branch gh-pages at 2026-04-09 16:19 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

…d binary

Move sourcemap inject+upload out of build-docs into a new
upload-docs-sourcemaps job that depends on both build-binary
and build-docs. Downloads the compiled linux-x64 binary and
uses it to inject debug IDs and upload sourcemaps — doubles
as a smoke test for the compiled binary.
@BYK BYK marked this pull request as ready for review April 9, 2026 15:42
- Move inject step into build-docs (before packaging) so deployed
  files have debug IDs for runtime _sentryDebugIds registration
- Use SENTRY_ORG/SENTRY_PROJECT env vars instead of invalid positional arg
- Remove separate upload-docs-sourcemaps job (merged into build-docs)
- Delete .map files after upload (not needed in production)
- build-docs now depends on build-binary to use compiled CLI
….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
Copy link
Copy Markdown
Contributor

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 2cf3d4a. Configure here.

@BYK BYK merged commit ac7e9e0 into main Apr 9, 2026
27 checks passed
@BYK BYK deleted the feat/docs-sourcemaps branch April 9, 2026 16:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant