natui/dev

The natui/dev entrypoint exposes the same state-preserving development server used by the natui dev command.

createDevServer

import { createDevServer } from 'natui/dev';

const server = await createDevServer({
  root: process.cwd(),
  entry: 'src/main.tsx',
});

const close = async () => {
  await server.close();
};

process.once('SIGINT', () => void close());
process.once('SIGTERM', () => void close());

The watcher keeps the process alive. The signal handlers use the returned server handle to cleanly stop the watcher and native host.

The executable entry must call run() once. The server watches the application's local source graph, applies React Fast Refresh after successful builds, and keeps the previous native UI mounted after a build or evaluation error.

NatuiDevServer

close() stops the build watcher, unmounts React, asks the native host to quit, and removes temporary build output. Calling it more than once is safe.

The server runs its module builder in-process and does not open an HTTP port.