Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Desktop WebKit wrapper for HTML/CSS/JS applications.
Objective-C C
Latest commit df9455c @jeff-h jeff-h Fix GIT conflict resolution.


The MacGap project provides HTML/JS/CSS developers an Xcode project for developing Native OSX Apps that run in OSX's WebView and take advantage of WebKit technologies.

The project exposes a JavaScript API for OS X integration, such as displaying native OS X 10.9 notifications. The MacGap project is extremely lightweight and nimble; a blank application is about 980KB.


  • tiny compiled app sizes
  • Mac App Store compatible
  • access to many Mac OS X-specific features


MacGap works on OSX 10.6 and later.

Generate apps with the macgap generator, no compile necessary.

gem install macgap

macgap new myapp
macgap build myapp


MacGap exposes an object called macgap inside JavaScript. You can use it to alter the Dock icon and display Growl notifications, amongst other things. The API is documented in the WIKI on GitHub:


MacGap was forked/ported from Phonegap-mac. It's under the same license (MIT).

Custom Build

To build, make sure you have installed the latest Mac OSX Core Library. Download at

Just clone the repository and build in Xcode. The file public/index.html is loaded on startup.

Something went wrong with that request. Please try again.