# ClientVM demos

> Every demo below boots a ClientVM instance in your browser: no server, no sign-up, and nothing leaves the device. Each one shows a claim the docs make, working.

- [Todo app](https://clientvm.joeldsouza.me/demos/todo-vite-react.md) (Frameworks): A React todo app on the Vite dev server, with an API you can curl from bash and code that hot-reloads as you edit it.
- [Express server](https://clientvm.joeldsouza.me/demos/express.md) (Servers): A real npm install of Express from the registry, then its server, which restarts as you edit server.js.
- [Shell & Node](https://clientvm.joeldsouza.me/demos/shell.md) (Shell & tools): An interactive bash with pipes, background jobs and Node.js, and no install step, so it is ready in a second.
- [Agent drives the app](https://clientvm.joeldsouza.me/demos/agent-drives-preview.md) (Agents): The tool calls an AI agent makes: read the running app, click and type in it, check its console and edit its files.
- [Tailwind on Vite 8](https://clientvm.joeldsouza.me/demos/vite8-tailwind.md) (Frameworks): Vite 8, React 19 and Tailwind CSS 4, with rolldown, lightningcss and Tailwind’s oxide scanner running as WebAssembly.
- [WebSocket chat](https://clientvm.joeldsouza.me/demos/websocket-chat.md) (Servers): A chat room on Express and ws: the page talks to the server over a real WebSocket, and bash posts into the same room.

## Questions

### Where does a demo run?

In this tab. The page creates an instance on its own sandbox origin, which runs bash, Node.js and npm in Web Workers. The preview is served by a service worker on that origin, so the app you see never leaves the browser.

### Which browsers work?

Chromium-based browsers (Chrome, Edge, Brave, Arc) version 137 or later. ClientVM v1 relies on Document-Isolation-Policy, which other engines do not ship yet.

### Why is the first run slower?

The first time, npm and any WebAssembly build tools are downloaded and checked, and presets are built once. They are cached in your browser, so later runs start in seconds.

### Can I use one as a starting point?

Yes. Each demo links to its files on GitHub, and the code under “How it’s built” is the ClientVM part. Open it in the playground to change it first.
