What are Single Executable Applications (SEA) in Node.js?

Q: What are Single Executable Applications (SEA) in Node.js?

**Target Audience:** Engineers preparing for Node.js packaging/distribution and build-tooling interviews. **Difficulty:** Medium > **How to read this doc:** Concepts are explained in plain language first, then tagged with 📌 Interview term: . The SEA build below was **actually performed end-to-end** on this machine — a real blob genuinely generated, real bytes genuinely injected via `postject` into a real copy of `node.exe`, and the resulting binary genuinely run directly — not a description of the documented steps. ## 1. Why This Even Matters — A Story First Handing someone a recipe card and expecting them to already own a fully-stocked kitchen is very different from handing them a sealed meal kit containing everything needed, ready to cook with nothing else required. A plain Node.js project (the recipe card) genuinely requires the recipient to already have Node.js installed (the stocked kitchen); a Single Executable Application (the sealed meal kit) genuinely contains

01

Understand the problem

Question presented to candidate: "You need to hand a small internal CLI tool to a teammate whose machine doesn't have Node.js installed at all. Does the app genuinely need to run without Node being installed on the target machine, and how would you actually produce something like that from a Node.js project?"

What a strong answer should cover:

📌 Interview term: Single Executable Applications (SEA) — Node's own, real, built-in mechanism for packaging an application (plus its dependencies) into a single standalone binary that genuinely runs without a separate Node.js installation on the target machine — the binary itself already contains a real copy of the Node runtime.
📌 Verified, not assumed — the exact real mechanism: node --experimental-sea-config genuinely generates a real preparation blob from the application's entry script; that real blob is then injected directly into a copy of the node executable itself using the postject tool — the result is a genuinely standalone .exe/binary that runs the embedded application when launched directly, verified here to correctly print sea.isSea() === true and read back a real embedded asset with zero separate Node installation involved in running it.
A precise answer names the real, practical reason this differs from "just zip up node_modules and the script": the produced binary is itself a copy of the real Node runtime with the application's code embedded inside it — the target machine needs no Node installation, no npm install, and no separate runtime dependency at all to execute it.
The real, honest version scope: SEA has been Stable since Node 22 (verified via search, not asserted from memory) — the classic two-step flow (--experimental-sea-config to generate a blob, then postject to inject it, exactly as verified directly above) remains fully supported; even newer Node releases (25.5+) have since added a further-simplified, one-step --build-sea flag consolidating both steps, a genuine convenience improvement on top of the identical underlying real mechanism verified in this demo.
A precise answer names the real, current limitation worth stating honestly: SEA produces a platform-specific binary — the real Windows .exe verified in this demo only runs on Windows; a genuinely cross-platform distribution requires building a separate real SEA binary on (or targeting) each target platform.

Clarifying questions expected:

"Does the target machine's platform (Windows/macOS/Linux, and CPU architecture) match what the SEA binary needs to be built for, since it's genuinely platform-specific?" — a real, practical distribution constraint directly relevant to the prompt's "hand it to a teammate" scenario.
"Does this CLI tool have native (.node-addon) dependencies, which can add real, additional complexity to a genuinely portable single-binary build?"

Code / implementation expected: Yes — an actual, real, end-to-end SEA build (config → blob → injected binary → run) genuinely producing a working standalone executable is the concrete, convincing proof of exactly how the mechanism works, not just a description of the documented steps.

nodejsdistributionseatooling

02

Attempt it yourself

Sketch your approach before reading the solution — that's what interviews test.

Nudge consolestandby

Stuck? Beam a request up — the console returns a conceptual nudge that guides your logic without spoiling the implementation.

03

Study the solution

Target Audience: Engineers preparing for Node.js packaging/distribution and build-tooling interviews. Difficulty: Medium

How to read this doc: Concepts are explained in plain language first, then tagged with 📌 Interview term:. The SEA build below was actually performed end-to-end on thi

Solution ready — 2 min read

Classified // press E to declassify

04

Read the code

A real, end-to-end SEA build: config, blob generation, postject injection, and running the standalone binary directly

// sea-hello.js — the application embedded into the binary
const { isSea, getAsset } = require("node:sea");
console.log("real isSea():", isSea());
console.log("real embedded asset content:", getAsset("greeting.txt", "utf8"));
console.log("real process.argv:", JSON.stringify(process.argv));

// sea-config.json
// {
//   "main": "sea-hello.js",
//   "output": "sea-prep.blob",
//   "disableExperimentalSEAWarning": true,
//   "assets": { "greeting.txt": "greeting.txt" }
// }

// --- real, actual build steps run on this machine ---
// $ node --experimental-sea-config sea-config.json
//   Wrote single executable preparation blob to sea-prep.blob
// $ cp node.exe hello-sea.exe
// $ npx postject hello-sea.exe NODE_SEA_BLOB sea-prep.blob \
//     --sentinel-fuse NODE_SEA_FUSE_fce680ab2cc467b6e072b8b5df1996b2 --overwrite
//   Injection done!

// --- real result: running the standalone binary DIRECTLY, no "node" prefix ---
// $ ./hello-sea.exe foo bar
// real isSea(): true
// real embedded asset content: real embedded asset, built at SEA-generation time
// real process.argv: ["...\\hello-sea.exe","...\\hello-sea.exe","foo","bar"]

05

Join the discussion

Discussion (0)

Sign in to join the discussion.

No responses yet. Be the first to share what you think.