Firefox OS Boilerplate App

This is a demo app for Firefox OS, loosely based on fxosstub, meant to act as a simple boilerplate for getting started with apps for Firefox OS.

It will give you a button to install it in Firefox OS - on a device, in the Firefox OS Simulator (Simulator Introduction) and in certain Nightly versions of Firefox.

It is a showcase of:

• Web Activities
• WebAPI usage
• Adding offline support and more in Firefox OS!

To add your own icon, I recommend using the Firefox OS app icons style guide.

Preview

To test/install this app, download the code and run it on a web server, or navigate to Firefox OS Boilerplate App in Firefox on a device or in the Firefox OS Simulator.

Alternatively, install it in the Firefox OS Simulator Dashboard by providing either of these URLs:

• http://robnyman.github.com/Firefox-OS-Boilerplate-App/
• http://robnyman.github.com/Firefox-OS-Boilerplate-App/manifest.webapp

Note: If you use the Add Directory option in the Simulator, make sure to change "launch_path": "/Firefox-OS-Boilerplate-App/index.html" to "launch_path": "index.html" and the icon paths accordingly since it runs it as a packaged app directly from the root folder of the Firefox OS Boilerplate App.

Packaged Apps

You can test packaged apps in version 2 and higher of the Firefox OS Simulator, by using the Add Directory button. If you want to access privileged APIs - such as deviceStorage, cross-domain XMLHttpRequest etc - you need to set type and permissions in the manifest file. E.g.

{
    "version": "1",
    "name": "Firefox OS Boilerplate App",
    "type" : "privileged"
    …

And:

"permissions": {
    "device-storage:pictures": {
        "access": "readcreate"
    },
    "systemXHR":{}
}

All options to test packaged apps are outlined in the How to install packaged apps in Firefox OS – options and tools article