Local

The local provider runs a remote on your machine, backed by a directory. Use it to exercise the full upload → deploy → download loop offline before wiring in a hosted provider.

Run the server

The quickest way needs no code — the CLI ships the server:

wvb remote local

This serves ~/.wvb/local on http://localhost:4313. See wvb remote local for its flags (--base-dir, --port, --allow-other-versions).

To embed the server yourself, @wvb/remote-local-provider exports a Hono app. Serve it with any Hono adapter:

npm install @wvb/remote-local-provider @hono/node-server

import { serve } from '@hono/node-server';
import { wvbRemote } from '@wvb/remote-local-provider';

const app = wvbRemote({ baseDir: '~/.wvb/local' });
serve({ fetch: app.fetch, port: 4313 });

Publish to it

@wvb/remote-local provides the uploader and deployer for your config, writing to the same directory the server reads.

npm install -D @wvb/remote-local

import { defineConfig } from '@wvb/config';
import { localRemote } from '@wvb/remote-local';

export default defineConfig({
  remote: {
    endpoint: 'http://localhost:4313',
    ...localRemote({ baseDir: '~/.wvb/local' }),
  },
});

localRemote() returns { uploader, deployer }. Spread it into remote so wvb upload and wvb deploy write bundles the local server can serve.