Firefox OS 2.5+ supports add-ons, a feature already familiar to Firefox Desktop users, which allows customization of specific apps or the whole OS — behaviour more to your liking. The Firefox Marketplace acts as a host for add-ons as well as apps; this article provides an overview of how to submit your add-ons for publication.
Submission step-by-step
- Navigate to Firefox Marketplace Content Tools and log in to the site.
- After you've logged in, select the Submit Firefox OS Add-on button to go to the Submit a Firefox OS Add-on page; this is where the process starts.
- Click Select a File and select the add-on zip package you want to submit. See the Add-on package structure section below for more details on the required package/manifest format.
- You can optionally add submission notes. These are only for review purposes and are not publicly available — testing instructions, test login details, etc.
- Click Submit. Your add-on will now be validated.
- If there are any errors you’ll be sent back to Step 3 to resubmit an updated zip file.
- If not, you will be redirected to your dashboard, where all your submissions will be listed.
- After a reviewer has looked at your add-on, an email will be sent to notify you of the outcome.
Editing and updating your add-on
After successful submission of your add-on, you can edit/update it by going to your dashboard and selecting Edit this add-on.
New add-on versions can be added on this page. Uploading a new version while a previous version is pending review will mark the previous version obsolete and the new version will then be marked pending review instead (a maximum of 1 version can be pending review at one time.)
Once a version is approved then that will be available for installation; it will remain available until a newer version is approved.
Add-on package structure
The add-on is submitted as a zip file. This section details what the zip must contain.
The manifest.json (Manifest file) must be in the root of the zip file. Key details are as follows:
name
is required.version
is required.description
is optional but will be used by the Marketplace on the Add-on detail page.icons
is used to find icons to display on the marketplace, and on the device when the add-on is installed.author
isn’t currently used by the Marketplace, but will be shown on the device when the add-on is installed.
The rest of your add-on will be a typical collection of CSS, JavaScript, icons, etc. Again, this should all be placed in the root of the zip file, not within a subfolder — don’t zip up your project folder; zip up the contents of the project folder.) For mroe information on developing add-ons, see Firefox OS add-ons.
Note: Validation describes the current state of the manifest validator.
Review Criteria
You can review the Firefox OS add-ons review criteria to make sure your add-on follows it.