Skip to content
Desktop WebKit wrapper for HTML/CSS/JS applications.
Objective-C C HTML
Branch: master
Clone or download
jeff-h Merge pull request #147 from amilajack/patch-1
Fixed markdown in readme
Latest commit 5730478 Jun 10, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
MacGap.xcodeproj Add status bar support. Mar 20, 2016
MacGap Add status bar support. Mar 20, 2016
public Add status bar support. Mar 20, 2016
.gitignore Fixed fullscreen grey bar bug Mar 11, 2012
LICENSE first commit Jan 9, 2012 Fixed markdown in readme Jun 10, 2017
application.icns first commit Jan 9, 2012


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.

You can’t perform that action at this time.