Create wrangler sourcemaps guide for Cloudflare#14089
Merged
AbhiPrasad merged 6 commits intomasterfrom Jun 24, 2025
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
1 Skipped Deployment
|
Bundle ReportChanges will increase total bundle size by 711 bytes (0.0%) ⬆️. This is within the configured threshold ✅ Detailed changes
Affected Assets, Files, and Routes:view changes for bundle: sentry-docs-client-array-pushAssets Changed:
view changes for bundle: sentry-docs-server-cjsAssets Changed:
|
coolguyzone
reviewed
Jun 23, 2025
docs/platforms/javascript/common/sourcemaps/uploading/wrangler.mdx
Outdated
Show resolved
Hide resolved
coolguyzone
reviewed
Jun 23, 2025
docs/platforms/javascript/common/sourcemaps/uploading/wrangler.mdx
Outdated
Show resolved
Hide resolved
coolguyzone
reviewed
Jun 23, 2025
docs/platforms/javascript/common/sourcemaps/uploading/wrangler.mdx
Outdated
Show resolved
Hide resolved
coolguyzone
reviewed
Jun 23, 2025
|
|
||
| ## Manual Setup | ||
|
|
||
| ### 1. Install Sentry CLI |
Contributor
There was a problem hiding this comment.
Suggested change
| ### 1. Install Sentry CLI | |
| ### 1. Install the Sentry CLI |
coolguyzone
reviewed
Jun 23, 2025
|
|
||
| ### 1. Install Sentry CLI | ||
|
|
||
| First, install Sentry CLI as a dev dependency: |
Contributor
There was a problem hiding this comment.
Suggested change
| First, install Sentry CLI as a dev dependency: | |
| First, install the Sentry CLI as a dev dependency: |
coolguyzone
reviewed
Jun 23, 2025
docs/platforms/javascript/common/sourcemaps/uploading/wrangler.mdx
Outdated
Show resolved
Hide resolved
coolguyzone
reviewed
Jun 23, 2025
docs/platforms/javascript/common/sourcemaps/uploading/wrangler.mdx
Outdated
Show resolved
Hide resolved
coolguyzone
reviewed
Jun 23, 2025
|
|
||
| 1. Going to **Project Settings > Source Maps** in Sentry | ||
| 2. Checking for your release in the "Artifact Bundles" tab | ||
| 3. Confirming that source maps are working by triggering an error and checking that the stack trace shows your original source code |
Contributor
There was a problem hiding this comment.
Consider adding a screenshot or arcade here to demonstrate how this looks in the product.
Contributor
Author
There was a problem hiding this comment.
Will add this in a follow-up!
coolguyzone
reviewed
Jun 23, 2025
|
|
||
| If you encounter build errors when adding source map flags: | ||
|
|
||
| 1. Make sure you're using a recent version of Wrangler |
Contributor
There was a problem hiding this comment.
Is there a minimum version of Wrangler that's a prerequisite here? If so, let's specify.
coolguyzone
reviewed
Jun 23, 2025
platform-includes/sourcemaps/overview/javascript.cloudflare.mdx
Outdated
Show resolved
Hide resolved
coolguyzone
reviewed
Jun 23, 2025
platform-includes/sourcemaps/overview/javascript.cloudflare.mdx
Outdated
Show resolved
Hide resolved
coolguyzone
reviewed
Jun 23, 2025
|
|
||
| ## Other Tools | ||
|
|
||
| If you're not using one of these tools, we assume you already know how to generate source maps with your toolchain and we recommend you upload them using <PlatformLink to="/sourcemaps/uploading/cli/">Sentry CLI</PlatformLink>. |
Contributor
There was a problem hiding this comment.
Suggested change
| If you're not using one of these tools, we assume you already know how to generate source maps with your toolchain and we recommend you upload them using <PlatformLink to="/sourcemaps/uploading/cli/">Sentry CLI</PlatformLink>. | |
| If you're not using one of these tools, we assume you already know how to generate source maps with your toolchain and we recommend you upload them using the <PlatformLink to="/sourcemaps/uploading/cli/">Sentry CLI</PlatformLink>. |
coolguyzone
approved these changes
Jun 23, 2025
Contributor
coolguyzone
left a comment
There was a problem hiding this comment.
Looks good! Please see the comment regarding the duplicated content.
Co-authored-by: Alex Krawiec <alex.krawiec@sentry.io>
AbhiPrasad
commented
Jun 24, 2025
docs/platforms/javascript/common/sourcemaps/uploading/wrangler.mdx
Outdated
Show resolved
Hide resolved
AbhiPrasad
commented
Jun 24, 2025
docs/platforms/javascript/common/sourcemaps/uploading/wrangler.mdx
Outdated
Show resolved
Hide resolved
bitsandfoxes
pushed a commit
that referenced
this pull request
Jul 3, 2025
Documents the changes from getsentry/sentry-wizard#999 ref getsentry/sentry-javascript#14841 A new sourcemaps guide for Wrangler was added to the Cloudflare documentation. * A new guide, `docs/platforms/javascript/common/sourcemaps/uploading/wrangler.mdx`, was created. * It details both automatic setup via the Sentry Wizard and manual configuration. * Manual steps include installing `@sentry/cli`, configuring `sentry-cli`, and modifying the `package.json` scripts. * The `deploy` script is updated to include `--outdir`, `--upload-source-maps`, and `--var SENTRY_RELEASE:$(sentry-cli releases propose-version)`. * A `sentry:sourcemaps` script is added to create releases and upload sourcemaps. * A `postdeploy` script is introduced to automatically run the `sentry:sourcemaps` command after deployment. * Instructions for configuring the Sentry SDK with `release: env.SENTRY_RELEASE` are provided. * The guide is marked as `supported: [javascript.cloudflare]` to ensure platform-specific visibility. * `platform-includes/sourcemaps/overview/javascript.cloudflare.mdx` was updated to include a "Cloudflare-Specific Tools" section, linking to the new Wrangler guide. * `platform-includes/sourcemaps/upload/primer/javascript.cloudflare.mdx` was modified to include the updated Cloudflare overview. These changes ensure that Wrangler users have a dedicated guide for sourcemap uploads, integrated seamlessly into the Cloudflare platform documentation. --------- Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: Alex Krawiec <alex.krawiec@sentry.io>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documents the changes from getsentry/sentry-wizard#999
ref getsentry/sentry-javascript#14841
A new sourcemaps guide for Wrangler was added to the Cloudflare documentation.
docs/platforms/javascript/common/sourcemaps/uploading/wrangler.mdx, was created.@sentry/cli, configuringsentry-cli, and modifying thepackage.jsonscripts.deployscript is updated to include--outdir,--upload-source-maps, and--var SENTRY_RELEASE:$(sentry-cli releases propose-version).sentry:sourcemapsscript is added to create releases and upload sourcemaps.postdeployscript is introduced to automatically run thesentry:sourcemapscommand after deployment.release: env.SENTRY_RELEASEare provided.supported: [javascript.cloudflare]to ensure platform-specific visibility.platform-includes/sourcemaps/overview/javascript.cloudflare.mdxwas updated to include a "Cloudflare-Specific Tools" section, linking to the new Wrangler guide.platform-includes/sourcemaps/upload/primer/javascript.cloudflare.mdxwas modified to include the updated Cloudflare overview.These changes ensure that Wrangler users have a dedicated guide for sourcemap uploads, integrated seamlessly into the Cloudflare platform documentation.