[Browser Run] Add local dev workaround for quickAction() binding

[kathayl]

What

Adds callouts documenting that the .quickAction() Workers binding method does not yet work in local development mode (wrangler dev). Users must use --remote or set "remote": true in their browser binding config.

Why

A customer (Ramp) hit this issue immediately after the changelog post went out. The error message (The RPC receiver does not implement the method "quickAction") is not obvious. This is a temporary workaround until BRAPI-1213 ships local support.

Where

• Quick Actions index (/browser-run/quick-actions/) - new caution callout in Workers binding section
• Wrangler reference (/browser-run/reference/wrangler/) - new caution callout below compat date note
• Changelog post (2026-05-28) - new note callout about local dev limitation

Related

• BRAPI-1213 - Implement quickActions on local dev browser binding
• Slack thread: https://cloudflare.enterprise.slack.com/archives/C083MC7MATF/p1780075978721999

[github-actions]

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
/src/content/docs/browser-run/	@mchenco, @cloudflare/product-owners, @celso, @kathayl, @dcpena, @meddulla, @simonabadoiu, @jonnyparris, @ruifigueira, @Refaerds, @omarmosid

[ask-bonk]

1 issue to address before merge.

MEDIUM — src/content/docs/browser-run/quick-actions/index.mdx lines 44–77: Two caution admonitions in the same ### Workers binding section violates the style guide limit of one per section. Please merge them into a single caution.

LOW — src/content/docs/browser-run/reference/wrangler.mdx line 82: The generic npx wrangler dev command appears directly after a caution stating Quick Actions require --remote in local development. Consider adding a qualifier (for example, “For general binding testing, run …”) to avoid confusion.

Suggested labels: browser-run, documentation.

[ask-bonk]

Posted a review on PR #31141.

Summary:

• 1 MEDIUM issue flagged: src/content/docs/browser-run/quick-actions/index.mdx has two caution admonitions in the same ### Workers binding section, which violates the style guide rule of one admonition type per section. The author should merge them into a single caution.
• 1 LOW issue flagged: src/content/docs/browser-run/reference/wrangler.mdx places the generic npx wrangler dev command immediately after a caution that Quick Actions require --remote. A qualifier would prevent reader confusion.
• Changelog addition looks correct and properly scoped.

Suggested labels: browser-run, documentation.

No build-breaking issues (MDX syntax, imports, links) were found.

github run

[cloudflare-docs-bot]

Review

⏸️ Automatic reviews for this PR are paused.

This PR has already received 2 automatic reviews. To run another review, a codeowner can comment /review or /full-review.

Tip: Keep PRs in draft mode until they are ready for review — the bot skips draft PRs automatically.

---

✅ No style-guide issues found in commit 9f7869e.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command	Description
/review	Runs a review now. Incremental if a prior review exists, full if not.
/full-review	Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.

[github-actions]

Preview URL: https://2ef2c9da.preview.developers.cloudflare.com
Preview Branch URL: https://kliao-quickaction-local-dev-workaround.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/browser-run/reference/wrangler/	https://kliao-quickaction-local-dev-workaround.preview.developers.cloudflare.com/browser-run/reference/wrangler/
https://developers.cloudflare.com/browser-run/quick-actions/	https://kliao-quickaction-local-dev-workaround.preview.developers.cloudflare.com/browser-run/quick-actions/

[ruifigueira]

LGTM