...
Make sure you have Node.js,Python,GCC installed, then type the following commands known to every Node developer...
yarn install
yarn start
...and you have a running desktop application on your screen.
Side note: Windows build tools
Side note: NW using native node modules
The application consists of two main folders...
src - files within this folder get transpiled or compiled (because NW can't use them directly).
app - contains all static assets which don't need any pre-processing. Put here images, CSSes, HTMLs, etc.
The build process compiles the content of the src folder and puts it into the app folder, so after the build has finished, your app folder contains the full, runnable application.
Treat src and app folders like two halves of one bigger thing.
The drawback of this design is that app folder contains some files which should be git-ignored and some which shouldn't (see .gitignore file). But this two-folders split makes development builds much, much faster.
npm start
Build process uses Webpack. The entry-points are src/app.js. Webpack will follow all import statements starting from those files and compile code of the whole dependency tree into one .js file for each entry point.
Babel is also utilised, but mainly for its great error messages. NW under the hood runs latest Chromium, hence most of the new JavaScript features are already natively supported.
Environmental variables are done in a bit different way (not via process.env). Env files are plain JSONs in config directory, and build process dynamically links one of them as an env module. You can import it wherever in code you need access to the environment.
import env from 'env';
console.log(env.name);To do so edit package.json:
"dependencies": {
"nw": "0.33.3-sdk"
}Side note: NW authors recommend to use fixed version here.
Remember to respect the split between dependencies and devDependencies in package.json file. Your distributable app will contain modules listed in dependencies after running the release script.
Side note: If the module you want to use in your app is a native one (not pure JavaScript but compiled binary) you should first run npm install name_of_npm_module and then npm run postinstall to rebuild the module for NW. You need to do this once after you're first time installing the module. Later on, the postinstall script will fire automatically with every npm install.
To package your app into an installer use command:
npm run release
Once the packaging process finished, the dist directory will contain your distributable file.
We use nw-builder to handle the packaging process. It has a lot of customization options, which you can declare under "build" key in package.json.