While browser-based unhosted applications present some interesting possibilities, such as the ability to deploy your application on multiple operating systems, there are some significant limitations.
When using browsers one’s control of the user interface is limited. Some interface elements, such as pull-down menus, can’t be customized and there is usually no way to hide the browser’s address bar programatically.
Another potential issue with web applications in general is variance between browsers and browser versions. As HTML5 is still evolving, special care needs to be taken to ensure that everything works in all major browsers.
Last, but not least, most browsers are configured to be secure against malicious content. The same origin policy, for example, is enforced by default, preventing a site on one domain from making an AJAX call to another.
The node-webkit project, which was created at Intel and open sourced in 2011, is an attempt to take the pain out of offline single-page application development.
The project provides a WebKit browser that has been extended with the the ability to control user interface elements normally off-limits to web developers. The browser’s security configuration is relaxed, assuming that the application code you’re runnning is trusted. And, most interestingly, the browser integrates Node.js, allowing node-webkit applications to leverage a wide array of functionality other than what HTML5 APIs provide.
Now that you’ve got an idea what node-webkit is and what it’s useful for, let’s talk about how to install it.
node-webkit can be installed on Windows, OS X, and Linux. node-webkit, like Node.js, is easy to install. The “Downloads” section on the project’s Github page supplies a number archives containing ready-to-run node-webkit binaries and software libaries they depend on.
Once you’ve download the appropriate archive, you’ll need to locate the node-webkit binary. The Linux binary’s filename is
nw. The Window binary’s filename is
nw.exe. In the OS X version, which comes packaged as an application bundle, the binary is in the
Contents/MasOS folder and the filename is
node-wekit (for example
To install node-webkit, simply put the folder containing your node-webkit binary in a convenient place.
Creating a simple application
As with Node, a package.json file is used to describe the application.
package.json file is also used to configure the properties of node-webkit’s default window. Below is an example of a node-webkit
In the window specification height, width, and whether the address bar should be included can be set. node-webkit applications can even be put into a full-screen “kiosk” mode, preventing users from exiting into the host operating system.
Using Node Functionality
Including Node functionality in your application is fairly straightforward. As with conventional Node applications, Node modules can be installed using [npm]. A markdown module, for example, could be installed using the following command:
npm install markdown
node-webkit can include any module in your application’s
node_modules directory by using a “require” statement, as the example below shows.
var markdown = require('markdown').markdown;
Now that you’ve learned the basics of application creation, let’s look at how your can package your application, enablnig you to run it yourself or distribute it to others.
Packaging Your Application
Packaging is very simple: you need only create a ZIP archive. To do so use a GUI archiving tool or, if using the OS X or Linux command-line, enter the following from within your project directory:
zip -r my_application.nw *
After zipping your application, you should rename it, giving it the extension
.nw to indicate that it’s a node-webkit application. The zipped application can be executed using the node-webkit runtime. For example:
To make distribution easier, stand-alone node-webkit applications can be created. This means that application end users don’t need to install node-webkit, or even know what it is. Check out the project’s wiki page for details.
If node-webkit sounds like something you’d like to play with, the nw-sample-apps project provides a number of example applications you can learn from and experiment with.
If you run into difficulties, a Google Group exists for questions and discussion about the technology. Have fun with node-webkit!
Looking for Node.js and API development training? StrongLoop instructors are coming to a city near you:
- Nov 6-7: Denver, CO at Galvanize Campus
- Nov 13-14: Herndon, VA at Vizuri
- Dec 3-4: Framingham, MA at Applause
- Dec 11-12: Minneapolis, MN at BestBuy
Check out our complete Node.js and API development training, conference and Meetup calendar to see where you can come meet with StrongLoop engineers.
- What’s in the upcoming Node v0.12 release? Big performance optimizations, read Ben Noordhuis’ blog to learn more.
- Ready to develop APIs in Node.js and get them connected to your data? Check out the Node.js LoopBack framework. We’ve made it easy to get started either locally or on your favorite cloud, with a simple npm install.
- Need training and certification for Node? Learn more about both the private and open options StrongLoop offers.