Skip to content

[Workers] Document source maps being uploaded by default - #34245

Merged
WalshyDev merged 1 commit into
productionfrom
walshy/wrangler-default-source-maps
Oct 20, 2026
Merged

WalshyDev merged 1 commit into
productionfrom
walshy/wrangler-default-source-maps

Conversation

@WalshyDev

@WalshyDev WalshyDev commented Oct 13, 2026 •

Copy link
Copy Markdown
Member

Summary

Wrangler now generates and uploads source maps by default for wrangler deploy, wrangler versions upload and wrangler preview (cloudflare/workers-sdk#16231, Wrangler 4.150.0). The Cloudflare Vite plugin and Wrangler's Build Output now also generate source maps by default (cloudflare/workers-sdk#16245, Vite plugin 1.64.0 and Wrangler 4.151.0), so cf deploy, which uploads every source map in the build output, gets them without configuration too.

This updates the source maps, Wrangler configuration and cf migration docs to describe the new defaults, how unresolvable maps are skipped unless upload_source_maps is true, and how to opt out with Wrangler and with cf. It also adds a changelog entry announcing the change.

Documentation checklist

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://walshy-wrangler-default-source-maps.previews.developers.cloudflare.com (commit 299da4e)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://285cdecc.previews.developers.cloudflare.com 299da4e 2026-10-20T23:12:50.653Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://885cd899.previews.developers.cloudflare.com 3ae5632 2026-10-19T16:55:28.538Z Visit the dashboard ↗
  • Build: In progress 🔵

View logs ↗
f881371 2026-10-19T15:57:43.322Z View logs ↗
  • Build: Failed ❌

View logs ↗
1b6ec3e 2026-10-19T14:58:17.663Z View logs ↗
  • Build: Failed ❌

View logs ↗
210806f 2026-10-16T21:26:09.194Z View logs ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://6322b7a4.previews.developers.cloudflare.com dbd996d 2026-10-13T12:00:53.786Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://94b49993.previews.developers.cloudflare.com 7d35e7b 2026-10-13T01:29:36.305Z Visit the dashboard ↗

@WalshyDev
WalshyDev force-pushed the walshy/wrangler-default-source-maps branch from 7d35e7b to dbd996d Compare October 13, 2026 11:42
@WalshyDev
WalshyDev marked this pull request as ready for review October 13, 2026 11:53
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor

AI Review

✅ Reviewed 299da4e · 2 findings · incremental

👉 Fix in your agent 👈
Fix the following review findings in PR #34245 (https://github.com/cloudflare/cloudflare-docs/pull/34245).

Before making changes, review each finding and present a brief summary table:
- For each finding, state whether you agree, disagree, or need clarification.
- If you disagree, explain why.
- If you need clarification before deciding, ask those questions.
- Then share your plan for which issues to tackle and in what order.

After triaging, follow this order:
1. Post a comment on this PR for any findings you are skipping, with the finding ID and your reasoning.
2. Then commit the fixes for the legitimate findings.

The comment must come before the commit because the next review reads PR comments.

## Style Guide
- S-15271766 | src/content/changelog/workers/2026-10-20-source-maps-on-by-default.mdx:18 | Remove contraction `don't`
  Prose contains the contraction `don't` in "they don't affect CPU time, bundle size, or cold starts". Remove contractions per the writing style rule.
- S-192ebd00 | src/content/changelog/workers/2026-10-20-source-maps-on-by-default.mdx:20 | Remove contraction `can't`
  Prose contains the contraction `can't` in "Maps it can't resolve, such as inline `data:` source maps". Remove contractions per the writing style rule.

Style Guide

  • src/content/changelog/workers/2026-10-20-source-maps-on-by-default.mdx:18 · Remove contraction don't

    Prose contains the contraction don't in "they don't affect CPU time, bundle size, or cold starts". Remove contractions per the writing style rule.

  • src/content/changelog/workers/2026-10-20-source-maps-on-by-default.mdx:20 · Remove contraction can't

    Prose contains the contraction can't in "Maps it can't resolve, such as inline data: source maps". Remove contractions per the writing style rule.

Resolved (2) · Dismissed (0)
  • Resolved: Contraction don't in prose · Cited file 2026-10-13-source-maps-on-by-default.mdx no longer exists at head; the entry was renamed to the 2026-10-20 file, and the same don't sentence is now at line 18 there, reported by kept finding S-15271766.
  • Resolved: Contraction can't in prose · Cited file 2026-10-13-source-maps-on-by-default.mdx no longer exists at head; the entry was renamed to the 2026-10-20 file, and the same can't sentence is now at line 20 there, reported by kept finding S-192ebd00.
Commands
  • /review Run a review now.
  • /full-review Review the entire PR diff.
  • /disable-auto-review Stop automatic reviews.
  • /rebase Rebase against production.

@cloudflare cloudflare deleted a comment from github-actions Bot Oct 16, 2026
@WalshyDev
WalshyDev force-pushed the walshy/wrangler-default-source-maps branch 2 times, most recently from 1b6ec3e to f881371 Compare October 19, 2026 15:56
@WalshyDev
WalshyDev force-pushed the walshy/wrangler-default-source-maps branch from f881371 to 3ae5632 Compare October 19, 2026 16:37
Wrangler now generates and uploads source maps by default for
`wrangler deploy`, `wrangler versions upload` and `wrangler preview`
(cloudflare/workers-sdk#16231). The Cloudflare Vite plugin and Wrangler's
Build Output now also generate source maps by default
(cloudflare/workers-sdk#16245), so `cf deploy`, which uploads every source
map in the build output, gets them without configuration too.

Update the source maps, configuration and cf migration docs to describe
the new defaults, the lenient handling of unresolvable maps, and how to
opt out with Wrangler and with cf, and add a changelog entry announcing it.
@WalshyDev
WalshyDev force-pushed the walshy/wrangler-default-source-maps branch from 3ae5632 to 299da4e Compare October 20, 2026 23:05
@WalshyDev
WalshyDev enabled auto-merge October 20, 2026 23:06
@WalshyDev
WalshyDev added this pull request to the merge queue Oct 20, 2026
Merged via the queue into production with commit 3fe915d Oct 20, 2026
13 checks passed
@WalshyDev
WalshyDev deleted the walshy/wrangler-default-source-maps branch October 20, 2026 23:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants