Nodepod documentation

Nodepod is a browser-native Node.js runtime for products that need real filesystem, shell, package, process, and HTTP primitives without sending every action to a backend.

npm install @scelar/nodepod

Run your first program

Choose a path

Embed a runtime

Boot Nodepod, seed files, spawn a Node.js process, and stream its output.

Add a terminal

Connect xterm.js to Nodepod’s persistent shell and virtual filesystem.

Run a server

Start a Node-compatible HTTP server and call it programmatically or through an isolated preview.

Use headless mode

Run the same core runtime in a browser, Node.js, or Bun without terminal or preview UI.

Integration requirements

• Nodepod supports current evergreen browsers with WebAssembly and Web Workers.
• Full synchronous and threaded behaviour requires cross-origin isolation and SharedArrayBuffer.
• Preview URLs require Nodepod’s service-worker and preview-bridge assets. Programmatic runtime and HTTP access can run with serviceWorker: false.
• Nodepod is source-available under MIT + Commons Clause. The repository LICENSE is authoritative.

Read compatibility and browser requirements before choosing a deployment mode.