One file. Both worlds.
Your UI and your logic run in the same JavaScript context, bridged to a native core.
- Node.js and the browser together. Import React next to
node:fs, node:net and node:crypto. Call your functions directly: no REST layer, no local server.
- Zero-config bundling. TypeScript and JSX are bundled by esbuild every time you run. No HTML file to write, no config to keep in sync.
- fetch without CORS.
fetch and WebSocket run in the native core, so any URL works from your UI. No proxy, no preflight.
- Commands you already know.
git, npm, ssh, curl and vi are built in. Like a terminal on Linux, the shell is where you start, not where you stop.
- Local-first. Projects live on the device. Nothing leaves it unless you push it.
- Tunnels to private services. Reach databases and internal APIs behind a firewall from any device. Drivers like
pg work unchanged. No port forwarding, no VPN.
Get started
From npm install to your phone: build locally, push to Git, run anywhere.
1. Install. Add FullStacked to any JavaScript or TypeScript project.
npm i fullstacked
Or npm i fullstacked@beta for the latest beta.
2. Write index.tsx. Use Node.js and browser APIs in the same file.
import React from "react";
import { createRoot } from "react-dom/client";
import fs from "node:fs";
function App() {
const message = fs.readFileSync("message.txt", "utf8");
return <h1>{message}</h1>;
}
const root = document.createElement("div");
document.body.append(root);
createRoot(root).render(<App />);
3. Run it. Bundle and run with one command.
npx fullstacked
4. Push. Any Git host works. No CI, no deploy step.
git commit -am "first version"
git push
5. Run it anywhere. Open the FullStacked app on any device, pull and run.
git clone https://github.com/you/my-project
cd my-project
npm install
fullstacked
Download
Install FullStacked in your projects and get the app on every device. The app opens on a shell: clone a repository and run it.
Stable releases are the ones to use.
Beta builds ship from every change to main, to try what's next before it's released.
See Releases for how versions and channels work.
If a project takes over the app, Cmd+Shift+T (Apple), Ctrl+Shift+T (Windows, Linux, Android) or holding three fingers on a touch screen for 1.5s restarts it on the shell in safe mode.
The Node.js you know, on every device
Projects import Node's built-in modules as they would in Node (node: prefix or not). The runtime serves them from core/internal/bundle/lib, TypeScript written for the webview, with no npm shim: what needs the system or heavy computation calls the Go core. Database drivers like pg, ioredis and mongodb work as-is.
| Module | Runs in |
|---|
assert, buffer, console, constants, diagnostics_channel, events, perf_hooks, querystring, stream (+ /promises, /web, /consumers), string_decoder, timers (+ /promises), url, util (+ /types) | the page, in TypeScript |
fs (+ /promises), net, dgram, dns (+ /promises), os, path, process | the core: files, sockets and the system |
crypto | MD5, SHA-1, SHA-2, HMAC, AES-CTR, ChaCha20 and random bytes in TypeScript; other ciphers (GCM, CBC, ChaCha20-Poly1305, 3DES), keys, signatures, DH/ECDH and the KDFs in the core |
zlib | the core (deflate, gzip, brotli; the callback forms and streams off the page's thread); crc32 in TypeScript |
worker_threads, readline (+ /promises), tty | the page (worker_threads over the webview's web workers) |
http, https, http2, tls | not available (use fetch) |
child_process, async_hooks, module, vm, v8, sqlite | not available |
fetch and WebSocket go through the core as well, and DOMParser is provided in workers, where the webview has none. More in the docs.
FullStacked Cloud
Want to jumpstart your development? FullStacked Cloud gives you and your AI agent every resource to build any tool you imagine: Git hosting, managed databases, private network access and an MCP server. One click connects the app.
- Postgres, Redis, MongoDB and S3 in one click
- Share a project and it's on your team's devices instantly
- Let Claude or Cursor build it for you
Build from source
Requirements: Go >=1.26 and Node.js >=20. On Windows, also llvm-mingw =20250613.
git clone https://github.com/fullstackedorg/fullstacked.git
cd fullstacked
git submodule update --init
git -C shell submodule update --init
npm install
npm start
Contributing
FullStacked is built in the open. Issues, ideas and pull requests are welcome: open an issue or send a pull request.
Star it, fork it, build with it.
License
MIT © FullStacked
