Official site: https://nwjs.io
NW.js is an app runtime based on Chromium
and node.js
. You can
write native apps in HTML and JavaScript with NW.js. It also lets you
call Node.js modules directly from the DOM and enables a new way of writing
native applications with all Web technologies.
It was created in the Intel Open Source Technology Center.
Building a Cross-platform Desktop App with NW.js
Creating Desktop Applications With node-webkit
WebApp to DesktopApp with node-webkit (slides)
Essay on the history and internals of the project
- Apps written in modern HTML5, CSS3, JS and WebGL.
- Complete support for Node.js APIs and all its third party modules.
- Good performance: Node and WebKit run in the same thread: Function calls are made straightforward; objects are in the same heap and can just reference each other.
- Easy to package and distribute apps.
- Available on Linux, Mac OS X and Windows.
-
v0.87.0: (Apr 2nd, 2024, based off of Node.js v21.1.0, Chromium 124.0.6367.62) : release notes
NOTE You might want the SDK build. Please read the release notes. -
Mac 10.10+: 64bit
-
Use Legacy build for Win XP and early OSX.
-
latest nightly build from git tip: https://dl.nwjs.io/live-build/
-
Previous versions; See the mapping file for the version info in previous releases.
You may also be interested in our demos repository and the List of apps and companies using nw.js.
Create index.html
:
<!DOCTYPE html>
<html>
<head>
<title>Hello World!</title>
</head>
<body>
<h1>Hello World!</h1>
We are using node.js <script>document.write(process.version)</script>.
</body>
</html>
Create package.json
:
{
"name": "nw-demo",
"version": "0.0.1",
"main": "index.html"
}
Run:
$ /path/to/nw . (suppose the current directory contains 'package.json')
Note: on Windows, you can drag the folder containing package.json
to nw.exe
to open it.
Note: on OSX, the executable binary is in a hidden directory within the .app file. To run node-webkit on OSX, type:
/path/to/nwjs.app/Contents/MacOS/nwjs .
(suppose the current directory contains 'package.json')
Official documentation: http://docs.nwjs.io/
For more information on how to write/package/run apps, see:
And our Wiki for much more.
We use the google group as our mailing list (use English only). Subscribe via nwjs-general+subscribe@googlegroups.com.
NOTE: Links to the old google group (e.g. https://groups.google.com/forum/#!msg/node-webkit/doRWZ07LgWQ/4fheV8FF8zsJ
) that are no longer working can be fixed by replacing node-webkit
with nwjs-general
(e.g https://groups.google.com/forum/#!msg/nwjs-general/doRWZ07LgWQ/4fheV8FF8zsJ
).
Issues are being tracked here on GitHub.
The source code for NW.js and the daily development spans multiple repositories in this organization. This repository is for issue tracking, landing page, and part of the source code.
Starting from 0.32.0 the stable and nightly download directories contain a SHASUMS256.txt file that lists the SHA checksums for each file available for download, as well as the checksums for the files inside the download package.
The SHASUMS256.txt can be downloaded using curl
.
$ curl -O https://dl.nwjs.io/vx.y.z/SHASUMS256.txt
To check that a downloaded file matches the checksum, run
it through sha256sum
with a command such as:
$ grep nwjs-vx.y.z.tar.gz SHASUMS256.txt | sha256sum -c -
The stable releases (but not Nightlies) also have the GPG detached
signature of SHASUMS256.txt available as SHASUMS256.txt.asc. You can use gpg
to verify that SHASUMS256.txt has not been tampered with.
To verify SHASUMS256.txt has not been altered, you will first need to import the GPG key of NW.js maintainer to create releases. Use this command to import the key:
$ gpg --keyserver pool.sks-keyservers.net --recv-keys 78680FA9E21BB40A
(Key fingerprint is 1E8B EE8D 5B0C 4CBC D6D1 9E26 7868 0FA9 E21B B40A)
Next, download the SHASUMS256.txt.asc for the release:
$ curl -O https://dl.nwjs.io/vx.y.z/SHASUMS256.txt.asc
After downloading the appropriate SHASUMS256.txt and SHASUMS256.txt.asc files,
you can then use gpg --verify SHASUMS256.txt.asc SHASUMS256.txt
to verify
that the file has been signed by an authorized member of the NW.js team.
Once verified, use the SHASUMS256.txt file to get the checksum for the binary verification command above.
NW.js
's code in this repo uses the MIT license, see our LICENSE
file. To redistribute the binary, see How to package and distribute your apps