AppJS is an SDK to develop desktop applications using Node.js melded with Chromium. With AppJS you can develop desktop tools and applications using the same libraries and knowledge used to build websites. You get all the following in one package:
- JS, HTML5, CSS, SVG, WebGL provided by Chromium
- mature http/https servers and client APIs - Node
- filesystem, dns, cryptography, subprocesses, OS APIs - Node
- sandboxed code execution environements virtual machines - Node
- tools for exposing native C++ bindings to JavaScript--APIs for authoring and the tools for compiling - Node
- Site: appjs.org
- Community: mailing list
AppJS is under heavy development. Expect many API changes and things to break.
The below packages include everything needed to get started with AppJS, including Node.js, all dependencies, binaries, and a launcher ready to go out of the box. 1.) Extract to a folder. 2.) Double click on launch. 3.) Hello World.
AppJS 0.0.13 Complete Distributables:
AppJS 0.0.14 Beta Distributables:
These are a work in progress.
There is a complete example in the examples
folder.
var appjs = require('appjs');
// Creates a new window. Its invisible until window.show() get called.
// http://appjs/ is a special url. It is home for your application!
var window = app.createWindow("http://appjs/",{autoResize:false});
// Called when page load finishes.
window.on("ready",function(){
console.log("Event Ready called");
// Runs a script in browser context.
window.runInBrowser(function(){
var body = document.body;
body.style.color="#f60";
});
// Show created window ( see below )
window.show();
});
// Routing:
// you can use a static router:
// app.use(app.staticRouter('./public'));
// or you can handle requests manually:
app.get("/",function(req,res,next){
res.send("\
<html>\
<head><title>Hello World</title></head>\
<body>Hello World</body>\
</html>\
")
});
Due to the complex dependencies of AppJS, installation via npm is difficult and error prone.
- First you need Node 0.8+ installed.
- Then use npm to install node-gyp:
npm install node-gyp
. - Finally, install appjs:
npm install appjs
.
Currently the binaries require Node for the following architectures:
- Linux - 64 bit
- Mac - 32 bit
- Windows - 32 bit
- Mac OS X: Currently 32bit node only,
$ node -e "console.log(process.arch)"
-> ia32 - Linux:
sudo apt-get install libgtk2.0-dev
- Windows: Windows SDK, DirectX SDK, and Visual C++ 2010
The follow are things we're currently working on solutions for and are high on the priority list to fix/address.
- bridging of Node and browser JS context so sharing of objects directly is possible
- distribution tools to help package up your apps for deployment
- expanded platform APIs to cover the standard use-cases for desktop apps
( The MIT License )
Copyright (c) 2012 Morteza Milani and other AppJS contributors
See the LICENSE file for details.