Serve explorer ui from miniflare by emily-shen · Pull Request #12391 · cloudflare/workers-sdk

emily-shen · 2026-02-03T17:32:25Z

By commit:

Copies over the built files from local-explorer-ui to miniflare during miniflare's build
Rename to explorer.worker.ts instead of api.worker.ts
add asset serving to explorer worker

Reasoning:
This is not using the existing miniflare asset plugin (ie what workers assets uses). Instead, I've got the explorer worker to serve and route the assets instead using miniflare disk binding. I considered using the existing asset plugin, but there's no nice way right now to add a plugin to a plugin, and the plumbing ends up being quite convoluted to wire up all the components of the asset plugin. The current solution ends up being a lot fewer LOC.

Tests
- Tests included/updated
- Automated tests not possible - manual testing has been completed as follows:
- Additional testing not necessary because:
Public documentation
- Cloudflare docs PR(s):
- Documentation not necessary because: wip experimental thing

A picture of a cute animal (not mandatory, but encouraged)

changeset-bot · 2026-02-03T17:32:30Z

🦋 Changeset detected

Latest commit: f27afe7

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

claude · 2026-02-03T17:32:55Z

Claude finished @emily-shen's task —— View job

Changeset Review

✅ All changesets look good

The changeset .changeset/witty-dolls-win.md passes all validation criteria:

✅ Version type: minor is appropriate for a new experimental feature
✅ Changelog quality: Clear, meaningful description
✅ Markdown headers: No h1/h2/h3 headers used
✅ Analytics: N/A
✅ Experimental features: Includes note that this is an experimental, WIP feature ✨

pkg-pr-new · 2026-02-03T17:38:12Z

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@12391

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@12391

miniflare

npm i https://pkg.pr.new/miniflare@12391

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@12391

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@12391

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@12391

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@12391

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@12391

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@12391

wrangler

npm i https://pkg.pr.new/wrangler@12391

commit: f27afe7

devin-ai-integration

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 6 additional flags.

devin-ai-integration

Devin Review found 1 new potential issue.

View issue and 10 additional flags in Devin Review.

packages/miniflare/src/workers/local-explorer/resources/kv.ts

devin-ai-integration

Devin Review found 1 new potential issue.

View issue and 10 additional flags in Devin Review.

packages/miniflare/src/workers/local-explorer/explorer.worker.ts

devin-ai-integration

Devin Review found 2 new potential issues.

View issues and 13 additional flags in Devin Review.

packages/miniflare/src/plugins/core/index.ts

fixtures/worker-with-resources/tests/index.test.ts

since it will serve assets too

devin-ai-integration

Devin Review found 1 new potential issue.

View issue and 19 additional flags in Devin Review.

packages/miniflare/src/plugins/core/index.ts

packages/miniflare/scripts/build.mjs

packages/local-explorer-ui/src/main.tsx

packages/miniflare/src/workers/local-explorer/explorer.worker.ts

petebacondarwin

LGTM!

petebacondarwin · 2026-02-05T13:32:39Z

packages/miniflare/scripts/build.mjs

+ */
+function copyLocalExplorerUi(outPath, pkgRoot) {
+	const localExplorerUiSrc = path.join(pkgRoot, "../local-explorer-ui/dist");
+	const localExplorerUiDest = path.join(outPath, "local-explorer-ui");


I wonder if it is worth putting "local-explorer-ui and similar into constants that can be shared with the Miniflare plugin, just to avoid accidentally missing some when we inevitably rename or relocate this stuff?

workers-devprod added this to workers-sdk Feb 3, 2026

github-project-automation bot moved this to Untriaged in workers-sdk Feb 3, 2026

emily-shen marked this pull request as ready for review February 3, 2026 17:35

emily-shen requested a review from a team as a code owner February 3, 2026 17:35

devin-ai-integration bot reviewed Feb 3, 2026

View reviewed changes

emily-shen force-pushed the emily/ui-serving branch from 66018cd to 5263a88 Compare February 3, 2026 17:57

devin-ai-integration bot reviewed Feb 3, 2026

View reviewed changes

packages/miniflare/src/workers/local-explorer/resources/kv.ts Show resolved Hide resolved

emily-shen force-pushed the emily/ui-serving branch from 5263a88 to c6648c9 Compare February 3, 2026 18:02

devin-ai-integration bot reviewed Feb 3, 2026

View reviewed changes

packages/miniflare/src/workers/local-explorer/explorer.worker.ts Show resolved Hide resolved

emily-shen force-pushed the emily/ui-serving branch from d861d25 to bb007dd Compare February 4, 2026 11:42

devin-ai-integration bot reviewed Feb 4, 2026

View reviewed changes

packages/miniflare/src/plugins/core/index.ts Show resolved Hide resolved

fixtures/worker-with-resources/tests/index.test.ts Outdated Show resolved Hide resolved

emily-shen force-pushed the emily/ui-serving branch from bb007dd to 30811e0 Compare February 4, 2026 11:48

emily-shen added 2 commits February 4, 2026 11:49

wrangler -> cloudflare devtools

8532b7e

bundle into minfilare

8577fed

emily-shen force-pushed the emily/ui-serving branch from 30811e0 to 054e1c0 Compare February 4, 2026 14:35

emily-shen added 2 commits February 4, 2026 14:35

Rename to explorer.worker.ts instead of api.worker.ts

406c714

since it will serve assets too

add asset serving to explorer worker

c998137

emily-shen force-pushed the emily/ui-serving branch from 054e1c0 to c998137 Compare February 4, 2026 14:35

emily-shen changed the title ~~wip: serve explorer ui from miniflare~~ Serve explorer ui from miniflare Feb 4, 2026

emily-shen force-pushed the emily/ui-serving branch 2 times, most recently from 447c566 to c998137 Compare February 4, 2026 16:53

changeset

a2476e9

devin-ai-integration bot reviewed Feb 4, 2026

View reviewed changes

packages/miniflare/src/plugins/core/index.ts Show resolved Hide resolved

vicb reviewed Feb 5, 2026

View reviewed changes

packages/miniflare/scripts/build.mjs Outdated Show resolved Hide resolved

vicb reviewed Feb 5, 2026

View reviewed changes

packages/local-explorer-ui/src/main.tsx Outdated Show resolved Hide resolved

vicb reviewed Feb 5, 2026

View reviewed changes

packages/miniflare/src/workers/local-explorer/explorer.worker.ts Outdated Show resolved Hide resolved

vicb reviewed Feb 5, 2026

View reviewed changes

packages/miniflare/src/workers/local-explorer/explorer.worker.ts Show resolved Hide resolved

PR feedback

f27afe7

petebacondarwin approved these changes Feb 5, 2026

View reviewed changes

github-project-automation bot moved this from Untriaged to Approved in workers-sdk Feb 5, 2026

emily-shen merged commit ce9dc01 into main Feb 5, 2026
49 of 54 checks passed

emily-shen deleted the emily/ui-serving branch February 5, 2026 14:34

github-project-automation bot moved this from Approved to Done in workers-sdk Feb 5, 2026

workers-devprod mentioned this pull request Feb 5, 2026

Version Packages #12427

Merged

vicb mentioned this pull request Feb 5, 2026

refactor: minor update for the local explorer #12430

Merged

5 tasks

Conversation

emily-shen commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

claude bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changeset Review

Uh oh!

pkg-pr-new bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

devin-ai-integration bot left a comment

Choose a reason for hiding this comment

✅ Devin Review: No Issues Found

Uh oh!

devin-ai-integration bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

devin-ai-integration bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

devin-ai-integration bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

devin-ai-integration bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

petebacondarwin left a comment

Choose a reason for hiding this comment

Uh oh!

petebacondarwin Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

emily-shen commented Feb 3, 2026 •

edited

Loading

changeset-bot bot commented Feb 3, 2026 •

edited

Loading

claude bot commented Feb 3, 2026 •

edited

Loading

pkg-pr-new bot commented Feb 3, 2026 •

edited

Loading