Skip to content

chore(examples): rename hub examples to custom-hub-* and drop -minimal suffix - #346

Merged
antfu merged 1 commit into
mainfrom
chore/rename-hub-examples
Sep 3, 2026
Merged

chore(examples): rename hub examples to custom-hub-* and drop -minimal suffix#346
antfu merged 1 commit into
mainfrom
chore/rename-hub-examples

Conversation

@antfubot

@antfubot antfubot commented Sep 3, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Renames the two full hand-rolled hub reference hosts: examples/hub-viteexamples/custom-hub-vite, examples/hub-nextexamples/custom-hub-next.
  • Drops the -minimal suffix from the default-createUi() family: hub-vite-minimalhub-vite, hub-next-minimalhub-next, and likewise for hub-deno, hub-fastify, hub-hono, hub-nitro, hub-rsbuild, hub-sveltekit.
  • Updates package.json name/homepage fields and every cross-reference across AGENTS.md, docs, turbo.json, knip.jsonc, scripts, and tests to match.
  • Regenerates the tsnapi snapshot and lockfile affected by a doc-string rename.

🤖 Generated with the help of an agent

…l suffix

- hub-vite -> custom-hub-vite, hub-next -> custom-hub-next (full reference hosts)
- hub-*-minimal -> hub-* (deno, fastify, hono, next, nitro, rsbuild, sveltekit, vite)
- update package.json names/homepages and all references across docs, AGENTS.md, turbo.json, knip.jsonc, scripts, and tests
@coldtea-pr-lens

coldtea-pr-lens Bot commented Sep 3, 2026

Copy link
Copy Markdown

◈ PR Lens

🟢 +7 new · 🟠 ~7 changed · 🔴 -0 removed · 0 flows · 22 files · commit 02a87e6


Architecture

Architecture diagram for devframes/devframe at 02a87e6

14 components touched across 3 lanes.

Open full size


Inside the changed components — 3 views

Component view — Next.js Custom Hub Reference Host

Internal components of the custom Next.js hub host featuring custom React UI, JSON renderer, and App Router route handler.

Architecture view of Component view — Next.js Custom Hub Reference Host in devframes/devframe

Component view — Vite Custom Hub Reference Host

Internal modules of the custom Vite reference host with vanilla DOM UI and server middleware plugin.

Architecture view of Component view — Vite Custom Hub Reference Host in devframes/devframe

Component view — Minimal Hub Hosts Architecture

Minimal host configurations for Vite and Next.js utilizing standard hub-ui embedded dock injection.

Architecture view of Component view — Minimal Hub Hosts Architecture in devframes/devframe

Data flow

No data-flow sequence changed in this PR.


Drill down
Client Runtimes & UI — 6 components
🟡 CHANGED Documentation Site

Documentation and ecosystem map updated with new minimal and custom hub paths.

🟢 NEW Custom React Client & Runtime

Hand-rolled React UI client implementing OTP auth view, dock stages, and drawer polling.

🟢 NEW React JSON-Render Frontend

Local React renderer component registered at client boot to render JSON-render specs.

🟢 NEW Vanilla DOM Client Runtime

Vanilla TypeScript browser client implementing interactive OTP authorization and dock rails.

🟡 CHANGED Minimal Next Host Page

Host page importing /__devframes/embedded.js to mount floating devtools dock.

🟡 CHANGED Minimal Vite Host Page

Host HTML document receiving auto-injected embedded dock script tag.

Framework Kits & Hosts — 8 components
🟡 CHANGED Vite Minimal Hub Host

Minimal Vite host mounting the devframe hub via viteDevframeHub with default embedded UI.

🟡 CHANGED Next.js Minimal Hub Host

Minimal Next.js App Router host mounting the hub handler and embedded dock bootstrap.

🟢 NEW Vite Custom Reference Hub

Reference Vite host exercising all hub subsystems with a custom vanilla DOM client and OTP auth.

🟢 NEW Next.js Custom Reference Hub

Reference Next.js App Router host featuring custom React UI, client runtime, and JSON renderer.

🟢 NEW Next Catch-All Route Handler

Serves mounted devframe SPAs, connection discovery endpoints, and Streamable-HTTP MCP.

🟢 NEW Vite Hub Server Plugin

Vite plugin wrapping initHub with custom RPC declarations and middleware routing.

🟡 CHANGED Minimal Next Hub Route

Single App Router catch-all route delegating to ensureHub for devtool serving.

🟡 CHANGED Minimal Vite Middleware Config

Vite configuration wiring viteDevframeHub with built-in plugins and default hub-ui.


View

  • Architecture lens
  • Data flow lens
  • Expand every detail
  • Show unchanged neighbours

Tip

Push a new commit and the whole comment re-renders for the new head. An older run never overwrites a newer one, so a slow render cannot put a stale diagram back.

🪧 More tips
  • Run PR Lens on your own machine: npx skills add coldteadotai/pr-lens installs the agent skill. Then tell your coding agent: "Diagram the change you just made with PR Lens and attach it to the pull request."
  • Draw a diff before it is even a pull request: npx @coldtea/pr-lens-cli analyze --base origin/main reads the diff with your own model key, and npx @coldtea/pr-lens-cli render .pr-lens/graph.json draws the same lenses on your machine.
  • The boxes under View are live. Tick Architecture lens or Data flow lens to choose which diagrams appear, or Expand every detail to open every drill-down at once. The comment redraws in place a few seconds later.
  • Show unchanged neighbours lists the components this change did not touch alongside the ones it did, so the drill-down shows what the changed code sits next to.
  • GitHub will not let you zoom an image in a comment. The link under each diagram opens it full size on a page of its own, where you can.
  • The CLI's render picks up .github/pr-lens.yml automatically and applies your corrections (renames, exclusions, lane pins) at draw time.
  • Would you rather run it from CI on a key of your own? Add .github/workflows/pr-lens.yml with coldteadotai/pr-lens/packages/action@v0 and a model key in your repository secrets, say GEMINI_API_KEY. The Action asks Gemini by default, or OpenAI and any endpoint speaking /chat/completions through its provider input.
  • PR Lens is free for open source. A star on the repository is what keeps it going.
  • The diagrams follow your GitHub theme, so dark mode gets the dark render and light mode the light one, and the moving dots show this pull request's data in motion.

◈ Rendered by PR Lens · crafted with ❤️ by the Coldtea team · Something drawn wrong?

@vercel

vercel Bot commented Sep 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
devframe Ready Ready Preview Sep 3, 2026 11:12am UTC

@antfu
antfu merged commit e791666 into main Sep 3, 2026
13 of 14 checks passed
@antfu
antfu deleted the chore/rename-hub-examples branch September 3, 2026 11:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants