Add docs for wrangler dev + tunnels by ask-bonk[bot] · Pull Request #28228 · cloudflare/cloudflare-docs

ask-bonk · 2026-02-09T23:51:38Z

All tasks are complete. Here is a summary of the changes:

Summary of changes

New file

src/content/docs/workers/development-testing/expose-dev-server.mdx — New how-to page that walks through exposing a wrangler dev or vite dev session using Cloudflare Tunnel. Covers:
- How the tunnel architecture works
- Quick tunnels (no account required) with tabbed package manager examples
- Named tunnels with persistent hostnames
- Configuration details: port matching, interface binding, local vs remote mode, Vite custom ports
- Common use cases table
- Limitations

Edited files

src/content/docs/workers/development-testing/index.mdx (line 53) — Added a cross-link sentence after the "Get started" links in the Local development section: "To share your dev server with others or receive external webhooks, refer to Expose your dev server."
src/content/docs/cloudflare-one/.../trycloudflare.mdx (line 34) — Added a Workers-specific use case to the FAQ: exposing a local Workers dev server with cloudflared tunnel --url http://localhost:8787.
src/content/docs/workers/wrangler/commands.mdx (line 199) — Added a note under the --port flag description referencing the tunnel guide for port matching.

Validation

npm run check passed with 0 errors (frontmatter schemas, content collections, and Astro types all valid).

Closes #28227

github run

Co-authored-by: irvinebroque <irvinebroque@users.noreply.github.com>

github-actions · 2026-02-09T23:52:34Z

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

Pattern	Owners
`/src/content/docs/cloudflare-one/networks/connectors/cloudflare-tunnel/`	`@nikitacano`, `@ranbel`, `@cloudflare/pcx-technical-writing`
`/src/content/docs/workers/`	`@cloudflare/workers-docs`, `@GregBrimble`, `@irvinebroque`, `@mikenomitch`, `@korinne`, `@WalshyDev`, `@cloudflare/deploy-config`, `@cloudflare/pcx-technical-writing`, `@cloudflare/wrangler`, `@mattietk`, `@cloudflare/dev-plat-leads`

github-actions · 2026-02-10T00:06:23Z

Preview URL: https://417b7fb5.preview.developers.cloudflare.com
Preview Branch URL: https://opencode-issue28227-20260209234637.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/workers/development-testing/expose-dev-server/	https://opencode-issue28227-20260209234637.preview.developers.cloudflare.com/workers/development-testing/expose-dev-server/
https://developers.cloudflare.com/workers/development-testing/	https://opencode-issue28227-20260209234637.preview.developers.cloudflare.com/workers/development-testing/
https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/do-more-with-tunnels/trycloudflare/	https://opencode-issue28227-20260209234637.preview.developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/do-more-with-tunnels/trycloudflare/

irvinebroque · 2026-02-10T00:21:28Z

/bonk please work on these edits

don't say "edge"
remove the guidance that says "Do not use --remote, which uploads your code to the Cloudflare network and defeats the purpose of a tunnel to your local server." - this is not helpful
remove "Tunnel latency adds round-trip time to every request. This is acceptable for development but is not representative of production performance."

irvinebroque · 2026-02-10T00:23:05Z

/bonk fix Invalid link: /cloudflare-one/applications/configure-apps/self-hosted-public-app/ (found twice in one file).

ask-bonk · 2026-02-10T00:23:19Z

Bonk workflow failed. Check the logs for details.

View workflow run

Co-authored-by: irvinebroque <irvinebroque@users.noreply.github.com>

ask-bonk · 2026-02-10T00:24:34Z

Fixed both occurrences in src/content/docs/workers/development-testing/expose-dev-server.mdx:

Line 141: /cloudflare-one/applications/configure-apps/self-hosted-public-app/ → /cloudflare-one/access-controls/applications/http-apps/self-hosted-public-app/
Line 196: Same replacement in the use cases table

The correct path matches the 44 other references to this page across the codebase.

github run

petebacondarwin · 2026-02-10T09:34:55Z

+### Start your dev server
+
+<Tabs>
+  <TabItem label="npm">


Isn't there a component that automatically provides the different package manager options?

/bonk use the PackageManager component

ask-bonk · 2026-02-10T19:16:16Z

Changes made to src/content/docs/workers/development-testing/expose-dev-server.mdx:

Replaced manual Tabs/TabItem block with PackageManagers component (lines 33-37) — Uses <PackageManagers type="exec" pkg="wrangler" args="dev" /> and <PackageManagers type="exec" pkg="vite" args="dev" />, matching the pattern used on the parent development-testing/index.mdx page.
Also addressed the remaining review comments from @irvinebroque:
- Removed "at the Cloudflare edge" (line 20)
- Removed the "Local mode vs remote mode" section with the --remote guidance
- Removed the tunnel latency limitation bullet

github run

Address reviewer feedback to show dashboard-managed tunnels as the recommended approach alongside the CLI-based local configuration, using tabs to present both options concisely.

ask-bonk · 2026-02-10T23:39:05Z

Done. Here's what I changed in src/content/docs/workers/development-testing/expose-dev-server.mdx:

Rewrote the "Named tunnel (persistent hostname)" section to address @nikitacano's and @irvinebroque's feedback:

Added Tabs/TabItem components to present two approaches side by side:
- Dashboard (Recommended) — A concise 5-step walkthrough for creating a remotely-managed tunnel via the Cloudflare One dashboard, with a link to the full Create a tunnel (dashboard) docs.
- CLI — The existing local configuration approach (cloudflared tunnel login/create, config.yml, cloudflared tunnel run), preserved as-is.
The intro paragraph now explicitly notes that the dashboard approach is recommended.
The "Restrict access" subsection remains shared across both approaches.

github run

elithrar · 2026-02-20T15:08:08Z

/bonk update this PR: focus on the account level tunnel experience in https://developers.cloudflare.com/changelog/2026-02-20-tunnel-core-dashboard/ (follow the links in the changelog for guidance).

…orking > Tunnels) Per the 2026-02-20 changelog, Tunnel management for public applications is now available in the main Cloudflare Dashboard. Update the recommended dashboard flow to use Networking > Tunnels instead of the Cloudflare One dashboard.

ask-bonk · 2026-02-20T15:13:41Z

Done. Here is a summary of the change:

File changed: src/content/docs/workers/development-testing/expose-dev-server.mdx

What changed in the Dashboard (Recommended) tab:

Before: Directed users to log in to Cloudflare One and go to Networks > Connectors > Cloudflare Tunnels
After: Directs users to log in to the Cloudflare dashboard and go to Networking > Tunnels

This aligns with the 2026-02-20 changelog which announces that Tunnel management for public applications is now available in the main (Core) Cloudflare Dashboard. The changelog explicitly states the Core Dashboard at Networking > Tunnels is the right place for "securing origin servers and public applications" — which is exactly the use case of exposing a dev server via tunnel.

github run

elithrar · 2026-02-20T15:26:30Z

+
+## Limitations
+
+- Quick tunnels generate a new URL each time you restart `cloudflared`. For stable URLs, use a named tunnel.


/bonk things like "use a named tunnel" should be links for what / how to do that. re-review with that in mind + fix.

…ed concepts

ask-bonk · 2026-02-20T15:30:26Z

Done. Here is a summary of the changes in src/content/docs/workers/development-testing/expose-dev-server.mdx:

Added links to all previously-unlinked concept references:

Line 65: cloudflared CLI now links to the downloads page
Line 160: "Cloudflare Vite plugin" now links to /workers/vite-plugin/ (was linked earlier in the page but not in this section)
Lines 180-183 (Common use cases table): All "Quick tunnel" references now link to #quick-tunnel-no-account-required, all "named tunnel" references link to #named-tunnel-persistent-hostname
Line 187: "Quick tunnels" now links to the trycloudflare docs, "named tunnel" links to #named-tunnel-persistent-hostname
Line 190: "named tunnel" now links to #named-tunnel-persistent-hostname

github run

github-actions · 2026-03-07T03:45:06Z

Hey there, we've marked this pull request as stale because there's no recent activity on it. This label is helps us identify PRs that might need updates (or to be closed out by our team if no longer relevant).

github-actions · 2026-04-06T04:06:54Z

Hey there, we've closed out this pull request because it's been stale for a while and there's been no additional action on it. If these changes are still relevant, open a new pull request (or flag to us in a GitHub issue).

Add docs for wrangler dev + tunnels

9351330

Co-authored-by: irvinebroque <irvinebroque@users.noreply.github.com>

ask-bonk Bot requested review from a team and irvinebroque as code owners February 9, 2026 23:51

ask-bonk Bot requested a review from a team February 9, 2026 23:51

ask-bonk Bot requested review from GregBrimble, korinne and mikenomitch as code owners February 9, 2026 23:51

ask-bonk Bot mentioned this pull request Feb 9, 2026

Add docs for how to use wrangler dev with cloudflare tunnels #28227

Open

ask-bonk Bot requested review from a team, MattieTK, WalshyDev, nikitacano and ranbel as code owners February 9, 2026 23:51

github-actions Bot added product:workers Related to Workers product product:cloudflare-one size/m labels Feb 9, 2026

github-actions Bot assigned nikitacano, ranbel, GregBrimble, irvinebroque, korinne, MattieTK, mikenomitch and WalshyDev Feb 9, 2026

irvinebroque reviewed Feb 10, 2026

View reviewed changes

Comment thread src/content/docs/workers/wrangler/commands.mdx Outdated

Apply suggestion from @irvinebroque

a5639ef

This comment was marked as outdated.

Sign in to view

Fix invalid self-hosted-app links

46a2105

Co-authored-by: irvinebroque <irvinebroque@users.noreply.github.com>

nikitacano approved these changes Feb 10, 2026

View reviewed changes

nikitacano reviewed Feb 10, 2026

View reviewed changes

Comment thread src/content/docs/workers/development-testing/expose-dev-server.mdx

petebacondarwin reviewed Feb 10, 2026

View reviewed changes

Use PackageManagers component and address review feedback

b826fc5

Show both managed (recommended) and local tunnel setup

417b7fb

Address reviewer feedback to show dashboard-managed tunnels as the recommended approach alongside the CLI-based local configuration, using tabs to present both options concisely.

ask-bonk Bot mentioned this pull request Feb 18, 2026

Add docs-review skill for PR suggestions #28414

Merged

elithrar reviewed Feb 20, 2026

View reviewed changes

[Workers] Add missing links for quick tunnel, named tunnel, and relat…

6f4b521

…ed concepts

github-actions Bot added the stale label Mar 7, 2026

github-actions Bot added the closed-as-stale label Apr 6, 2026

github-actions Bot closed this Apr 6, 2026

github-actions Bot deleted the opencode/issue28227-20260209234637 branch April 22, 2026 04:57


		## Limitations

		- Quick tunnels generate a new URL each time you restart `cloudflared`. For stable URLs, use a named tunnel.

Uh oh!

Conversation

ask-bonk Bot commented Feb 9, 2026

Summary of changes

New file

Edited files

Validation

Uh oh!

github-actions Bot commented Feb 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

irvinebroque commented Feb 10, 2026

Uh oh!

Uh oh!

irvinebroque commented Feb 10, 2026

Uh oh!

This comment was marked as outdated.

ask-bonk Bot commented Feb 10, 2026

Uh oh!

ask-bonk Bot commented Feb 10, 2026

Uh oh!

Uh oh!

petebacondarwin Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

elithrar Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

ask-bonk Bot commented Feb 10, 2026

Uh oh!

ask-bonk Bot commented Feb 10, 2026

Uh oh!

elithrar commented Feb 20, 2026

Uh oh!

ask-bonk Bot commented Feb 20, 2026

Uh oh!

elithrar Feb 20, 2026

Choose a reason for hiding this comment

Uh oh!

ask-bonk Bot commented Feb 20, 2026

Uh oh!

github-actions Bot commented Mar 7, 2026

Uh oh!

github-actions Bot commented Apr 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

10 participants

github-actions Bot commented Feb 9, 2026 •

edited

Loading

github-actions Bot commented Feb 10, 2026 •

edited

Loading