Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including grunt-node-webkit-builder with all npm packages installed. Try it out:

require("grunt/package.json"); // grunt is a peer dependency. var gruntNodeWebkitBuilder = require("grunt-node-webkit-builder")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

grunt-node-webkit-builder v1.0.2

Let's you build your node webkit apps with grunt

grunt-node-webkit-builder NPM version Dependency Status


Let's you build your node-webkit apps for osx, win, and linux with grunt. It will download the prebuilt binaries for a specify version, unpacks it, creates a release folder, create the app.nw file for a specified directory and copys the app.nw file where it belongs.

Issues with the output should be reported on the node-webkit-builder issue tracker. Build Status

Getting Started

This plugin requires Grunt ~0.4.1

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-node-webkit-builder --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:


The "nodewebkit" task

Usage Examples

  nodewebkit: {
    options: {
        platforms: ['win','osx'],
        buildDir: './webkitbuilds', // Where the build version of my node-webkit app is saved
    src: ['./example/public/**/*'] // Your node-webkit app


Exactly the same as node-webkit-builder. You have the advantage to configure the files via Grunt.

Manifest Options


Just like node-webkit-builder you can specify platform-specific manifest values.

    "name": "nw-demo",
    "version": "0.1.0",
    "main": "index.html",
    "window": {
        "frame": false,
        "toolbar": false
    "platformOverrides": {
        "win": {
            "window": {
                "frame": true

For more information see node-webkit-builder's Manifest Options.

## Troubleshooting

OSX ulimit

Darwin (OS X kernel) has a low limit for file descriptors (256 per process) by default, so you might get an EMFILE error or an error mentioning "too many open files" if youtry to open more file descriptors than this.

To get around it, run ulimit -n 1024 (or add it to your ~/.bash_profile). For more information, see henvic/osx-ulimit.

Release History

  • 2014-12-12 1.0.0 64-bit support, improved platform-overrides and no more EMFILE errors. Also, macPlist CFBundleIdentifier is generated from package.json.
  • 2014-08-01 0.3.0 macPlist option improvements (see mllrsohn/node-webkit-builder#96)
  • 2014-08-01 0.2.0 Moved logic into a separate module, config options will be backward compatible except keep_nw is no longer supported
  • 2013-09-19 Removed config merging (but kept the lookup for version number and name), added keep_nw option, fixed various small bugs.
  • 2013-09-09 fixed accidential deletion of nw.exe on windows builds, adding several improvements, opt in for timestamped builds, using version and name from package.json to name the build product and build dir, renamed download directory to cache, added merge from package.json options for nodewebkit (no need to add configuration to Gruntfile, but stays optional)
  • 2013-08-20 fix for the unzip lib
  • 2013-08-13 initial release
RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free