Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Apache Cordova Boot 2 Gecko implementation
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


Apache Cordova Firefox OS implementation


  • Android SDK must be installed
  • on Mac OSX you need to have Xcode & the Command Line Tools for Xcode
  • on Windows you need to have CYGWIN
  • Firefox OS device with OS Version prerelease or Firefox OS simulator add-on

How to get started:

  1. Bootstrap your computer so to make sure that you have all the prerequisites for building Firefox
  2. instructions can be found under the "Build prerequisites" section on the following page:
  3. Clone the Firefox repository: git clone git://
  4. Build Firefox by following the instructions under the "Building" on the following page:
  5. Clone the cordova-firefoxos repository

If Deploying to device:

  1. Modify the XPCSHELL constant in the Makefile to point to the location of xpcshell on your computer
  2. Modify the ADB constant in the Makefile to point to the location of adb on your computer
  3. Make sure the Firefox OS device has remote debugging enabled. To enable remote debugging navigate to the following settings on the device: Settings->Device Information->More Information->Developer->Remote Debugging.
  4. Run the Makefile by typing "make" into the command line.
  5. The device should prompt you to allow a remote connection, your Apache Cordova Firefox OS app will be installed to the device once you accept the prompt.

If Deploying to simulator:

  1. Open the Firefox OS simulator add-on by going to Tools->Web Developer->Firefox OS Simulator
  2. Start the simulator
  3. Click on the Add Directory button and then choose the manifest.webapp file in the framework folder of your Apache Cordova app.
Something went wrong with that request. Please try again.