Node.js

Runs a Node.js project in a dedicated on-device Node server; the WebView points at the local port.

When to use

Express/Fastify/Koa apps, APIs, and server-side demos.

Runtime

• Version — Node.js 18.20.x.
• Process model — runs in a dedicated :nodejs OS process via a native node_launcher wrapper loading libnode.so, so the V8 lifecycle is isolated from the host.
• Addons — custom native .node extensions supported.
• Managed in the Linux Environment and Runtime Management screens.

Export requirements

The exported APK embeds:

• libnode_bridge.so
• libnode.so (16KB-aligned for Android 15+)
• libc++_shared.so

Missing any of these causes loadNode / loadJniBridge failure at runtime.

Core config

Backed by NodeJsConfig.

Project

• Project (projectId/projectName, sourceProjectPath) — the Node source.
• Framework (framework) — detected framework, if any.
• Node version (nodeVersion).
• Has node_modules (hasNodeModules) — whether dependencies are bundled.

Build mode

• Build mode (buildMode):
  • STATIC — static site
  • SSR — server-side rendering
  • API_BACKEND — API backend (default)
  • FULLSTACK — full-stack

Server

• Entry file (entryFile) — defaults to index.js.
• Port (serverPort) — allocated through the Port Manager.
• Environment variables (envVars) — key/value pairs passed to the process.

Native addons

• Custom Node extensions (customNodeExtensions) — add .node addons, each with load order.