Skip to content

Frameworks

The framework packages — @devframes/vite, @devframes/nuxt, and @devframes/next — integrate devframe with a specific meta-framework's dev server. Each one splits into two clearly-scoped subpaths, because you're always doing one of two distinct jobs:

ScopeSubpathYou are…
dev-spa.../dev-spabuilding & dev-serving a single devframe's SPA with that tool
hub.../hubmounting a whole devframes-hub (many integrations) inside that tool

The bare package root (@devframes/vite, @devframes/nuxt, @devframes/next) has no export — it throws with a pointer to the two subpaths, so an accidental bare import fails loudly instead of resolving to nothing.

Packagedev-spahub
@devframes/vitedevframeVitePlugin / devframeViteBridge / devframeViteviteDevframeHub (+ /hub/client)
@devframes/nuxtthe Nuxt module (modules: ['@devframes/nuxt/dev-spa'])the hub Nuxt module (+ /hub/client)
@devframes/nextwithDevframe + createDevframeNextHandler (+ /dev-spa/client)nextDevframeHub (+ /hub/client)

dev-spa: author one devframe

The dev-spa scope is for when the thing you're building is a devframe — you author its UI with Vite/Nuxt/Next and want its RPC backend running during development. See each package's page for the details; for the framework-neutral CLI/build/embedded outputs, reach for the adapters instead.

hub: mount a devframes-hub

The hub scope mounts an @devframes/hub — many integrations under one namespace, one merged RPC registry — inside the tool's dev server. Each hub entry wraps initHub, defaults the UI slot to @devframes/hub-ui's createUi() (override with ui, or ui: false for a headless hub you drive with the matching /hub/client helper), and mounts everything behind one catch-all.

  • ViteviteDevframeHub() shares Vite's dev server and injects the floating dock.
  • Nuxt — the hub Nuxt module wires the Vite hub plugin into nuxt dev.
  • NextnextDevframeHub() serves the hub from one App Router route on a side-car socket.

Vite and Nuxt already have native hub viewers (Vite DevTools, Nuxt DevTools) that integrate the same hub protocol, so @devframes/vite/hub and @devframes/nuxt/hub print a one-time recommendation to prefer those (silence with { quiet: true }). Next has no native counterpart, so @devframes/next/hub stays quiet.

Released under the MIT License.