Skip to content
This repository has been archived by the owner on Mar 21, 2022. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

📌 Deprecation Notice

This repository is deprecated and no more work will be done on this by Apache Cordova. You can continue to use this and it should work as-is but any future issues will not be fixed by the Cordova community.

Feel free to fork this repository and improve your fork. Existing forks are listed in Network and Forks.

As an alternative you could use the cordova-electron platform or use cordova-ios to build macOS apps.

Cordova OSX

CordovaLib is a framework that enables users to include Cordova in their OS X application projects easily, and also create new Cordova based OS X application projects.

Note that the current focus of this cordova platform is to provide kiosk-like applications for OSX, that usually run fullscreen and have little desktop interaction. So there is no direct support for menus, dock integration, finder integration, documents, etc. Think of it as a mobile app running on a very big screen.


Make sure you have installed the latest released OS X SDK which comes with Xcode 6 or later. Download it at or the Mac App Store.

Create your project

  1. (Optionally) Follow the instructions in the Command-Line Usage section of the Cordova Docs to create a new project. For example

    $ cordova create hello com.example.hello HelloWorld
  2. add the osx platform:

    $ cordova platform add osx
    $ cordova run osx
  3. You can also open the project in XCode:

    $ open platforms/osx/<yourproject>.xcodeproj

Add plugins

  1. for example, if you need the file-plugin do:

    $ cordova plugin add cordova-plugin-file

Create a Cordova OSX Standalone project

  1. Download the source

  2. execute the create command to setup an empty project:

    $ bin/create <path_to_new_project> <package_name> <project_name>

    for example

    $ bin/create ../Foo FooBar

Add plugins

  1. for example, if you need the file-plugin do:

    $ cordova plugin add cordova-plugin-file

Updating a CordovaLib subproject reference in your project

When you update to a new Cordova version, you may need to update the CordovaLib reference in an existing project. Cordova comes with a script that will help you to do this.

  1. Launch
  2. Go to the location where you installed Cordova, in the bin sub-folder
  3. Run update /path/to/your/project


How do debug the webview?

You need to enable the WebDeveloperExtras for your bundle:

defaults write com.yourcompany.yourbundleid WebKitDeveloperExtras -bool true

After you changed the defatuls, start the application and right-click inside the webview and select Inspect Element. This opens the Safari Developer Tools.

Note: The bundleid is usually the same as your widget id you define in your config.xml unless overridden by the ios-CFBundleVersion argument.