Firefox OS

  • Revision slug: Mozilla/Firefox_OS
  • Revision title: Firefox OS
  • Revision id: 478039
  • Created:
  • Creator: chrisdavidmills
  • Is current revision? No
  • Comment

Revision Content

Firefox OS is a new mobile operating system developed by Mozilla, which lets users install and run open web applications developed using HTML, CSS, and JavaScript.

Firefox OS is currently under heavy development; we are constantly working on ways to make it easier for you to:

  • Use the different developer features of Firefox OS
  • Use and customize Gaia (the default set of apps)
  • Build your own apps that will install and run of Firefox OS
  • Build the entire Firefox OS stack, or flash a phone with a build of Firefox OS

Platform guide

A guide for platform developers on how the different components of Firefox OS fit together and work.

Build & install

Guides covering building and installing Firefox OS on an emulator, compatible device, or desktop simulator.

Dev phones

Information on specific Firefox OS developer phones, such as tweaking, updating, recovering, and buying.

Getting help

If you're working with Firefox OS, or developing applications you'd like to run on Firefox OS devices, there are community resources to help you!

  • Consult the Boot to Gecko project forum: {{ DiscussionList("dev-b2g", "mozilla.dev.b2g") }}
  • Ask your question on Mozilla's Boot to Gecko IRC channel: #b2g

Don't forget about the netiquette...

Quick guide to Firefox OS

There is a handy quickfire guidebook available covering the bare essentials you need to develop Firefox OS Apps! Written by Andre Alves Garzia, the Quick Guide For Firefox OS App Development is available for free in PDF, ePUB and MOBI formats. Check it out today.

Note that we are keeping track of ongoing work on Firefox OS documentation on our Firefox OS documentation status page. If you want to help contribute to Firefox OS documentation, please have a look at this page to see what work needs doing!

 

  1. Introduction to Firefox OS
  2. Firefox OS usage tips
    1. Remote debugging
    2. Taking screenshots
  3. Firefox OS platform guide
    1. Gaia
    2. Gonk
    3. Gecko
    4.  Security
    5. Feature support chart
    6. Firefox OS architecture overview
    7. Firefox OS apps architecture
    8. Firefox OS settings list
  4. Build and install Firefox OS
    1. Firefox OS build prerequisites
    2. Preparing for your first Firefox OS build
    3. Building Firefox OS
    4. Porting Firefox OS
    5. Choosing how to run Gaia or Firefox OS
    6. Using Gaia in Firefox
    7. Using the Firefox OS desktop client
    8. Using the Firefox OS emulators
    9. Installing Firefox OS on a mobile device
    10. Dual boot of Firefox OS and Android on SGS2
  5. Hacking Firefox OS
    1. Modifying the hosts file
    2. Customization with the .userconfig file
    3. Testing Firefox OS
    4. Localizing Firefox OS
  6. Firefox OS developer phone guide
    1. Updating and Tweaking your Firefox OS Developer Preview phone/Geeksphone
    2. Troubleshooting
  7. Firefox OS release notes
    1. Firefox OS 1.2 for developers
    2. Firefox OS 1.1HD for developers
    3. Firefox OS 1.1 for developers
    4. Firefox OS 1.0.1 for developers
    5. Firefox OS API support table
    6. App permissions
  8. Firefox OS app design and development
    1. Apps zone
    2. Firefox OS visual design guidelines
    3. Tips and techniques
    4. Developer Hub
    5. Debugging on Firefox OS
    6. Using the Firefox OS app manager
    7. Localising Firefox OS Apps
    8. Performance

Revision Source

<div class="summary">
  <p>Firefox OS is a new mobile operating system developed by Mozilla, which lets users install and run open web applications developed using HTML, CSS, and JavaScript.</p>
</div>
<div class="column-container">
  <p>Firefox OS is currently under heavy development; we are constantly working on ways to make it easier for you to:</p>
  <ul>
    <li>Use the different developer features of Firefox OS</li>
    <li>Use and customize Gaia (the default set of apps)</li>
    <li>Build your own apps that will install and run of Firefox OS</li>
    <li>Build the entire Firefox OS stack, or flash a phone with a build of Firefox OS</li>
  </ul>
</div>
<div class="column-container">
  <div class="column-strip">
    <h2 class="title" id="Platform_guide"><a href="/en-US/docs/Mozilla/Firefox_OS/Platform">Platform guide</a></h2>
    <p><strong>A guide for platform developers on how the different components of Firefox OS fit together and work.</strong></p>
    <ul>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia">Gaia</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gonk" title="/en-US/docs/Mozilla/Firefox_OS/Platform/Gonk">Gonk</a></li>
      <li><a href="/en-US/docs/Mozilla/Gecko" title="/en-US/docs/Mozilla/Gecko">Gecko</a></li>
    </ul>
  </div>
  <div class="column-strip">
    <h2 class="title" id="Build_.26_install"><a href="/en-US/docs/Mozilla/Firefox_OS/Build_and_install">Build &amp; install</a></h2>
    <p><strong>Guides covering building and installing Firefox OS on an emulator, compatible device, or desktop simulator.</strong></p>
    <ul>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites" title="Mozilla/Firefox_OS/Firefox OS build prerequisites">Firefox OS build prerequisites</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Preparing_for_your_first_B2G_build" title="Mozilla/Firefox_OS/Preparing for your first B2G build">Preparing for your first build</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Building" title="Mozilla/Firefox_OS/Building">Building Firefox OS</a></li>
    </ul>
  </div>
  <div class="column-strip">
    <h2 class="title" id="Dev_phones"><a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide"><strong>Dev phones</strong></a></h2>
    <p><strong><strong>Information on specific Firefox OS developer phones, such as tweaking, updating, recovering, and buying.</strong></strong></p>
    <ul>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide/Updating_and_Tweaking_Geeksphone">Geeksphone</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Troubleshooting">Troubleshooting</a></li>
      <li><a href="https://marketplace.firefox.com/developers/dev_phone">Buy dev phones</a></li>
    </ul>
  </div>
</div>
<div class="column-container">
  <div class="column-strip column-4 zone-callout">
    <h2 id="Getting_help"><strong>Getting help</strong></h2>
    <p><strong>If you're working with Firefox OS, or developing applications you'd like to run on Firefox OS devices, there are community resources to help you!</strong></p>
    <ul>
      <li><strong>Consult the Boot to Gecko project forum: {{ DiscussionList("dev-b2g", "mozilla.dev.b2g") }}</strong></li>
      <li><strong>Ask your question on Mozilla's Boot to Gecko IRC channel: <a class="link-irc" href="irc://irc.mozilla.org/b2g" title="irc://irc.mozilla.org/b2g">#b2g</a></strong></li>
    </ul>
    <p><strong><span class="alllinks"><a class="external" href="http://www.catb.org/~esr/faqs/smart-questions.html" title="http://www.catb.org/~esr/faqs/smart-questions.html">Don't forget about the <em>netiquette</em>...</a></span></strong></p>
  </div>
  <div class="column-strip column-4">
    <div class="zone-callout">
      <h2 id="Quick_guide_to_Firefox_OS"><strong>Quick guide to Firefox OS</strong></h2>
      <p><strong>There is a handy quickfire guidebook available covering the bare essentials you need to develop Firefox OS Apps! Written by <a href="https://twitter.com/soapdog">Andre Alves Garzia</a>, the <a href="https://leanpub.com/quickguidefirefoxosdevelopment">Quick Guide For Firefox OS App Development</a> is available for free in PDF, ePUB and MOBI formats. Check it out today.</strong></p>
    </div>
    <div class="zone-callout">
      <h2 id="Other_Resources"><strong>Other Resources</strong></h2>
      <ul>
        <li><strong><a class="link-https" href="https://wiki.mozilla.org/B2G/FAQ" title="B2G/FAQ">Mozilla wiki FAQ</a></strong></li>
        <li><strong><a class="link-https" href="https://wiki.mozilla.org/B2G/Schedule_Roadmap" title="https://wiki.mozilla.org/B2G/Schedule_Roadmap">Roadmap</a></strong></li>
        <li><strong><a href="/en-US/docs/Mozilla/Firefox_OS/Feature_support_chart" title="/en-US/docs/Mozilla/Firefox_OS/Feature_support_chart">Feature support chart</a></strong></li>
        <li><strong><a href="/en-US/docs/Mozilla/Firefox_OS/Geeksphone_FAQ" title="/en-US/docs/Mozilla/Firefox_OS/Geeksphone_FAQ">Geeksphone FAQ</a></strong></li>
      </ul>
    </div>
  </div>
</div>
<div class="note">
  <p><strong>Note that we are keeping track of ongoing work on Firefox OS documentation on our <a href="/en-US/docs/Mozilla/Firefox_OS/Doc_Status">Firefox OS documentation status</a> page. If you want to help contribute to Firefox OS documentation, please have a look at this page to see what work needs doing!</strong></p>
</div>
<p>&nbsp;</p>
<h2 id="Subnav">Subnav</h2>
<ol>
  <li><a href="/en-US/docs/Mozilla/Firefox_OS/Introduction" title="Introductory information about what Firefox OS is and how it works.">Introduction to Firefox OS</a></li>
  <li><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_usage_tips" title="Short articles to explain various useful functions you can perform with Firefox OS to help with usage and development.">Firefox OS usage tips</a>
    <ol>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_usage_tips/Remote_debugging" title="How to set up your phone for remote debugging">Remote debugging</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_usage_tips/taking_screenshots" title="How to take screenshots on your Firefox OS phone">Taking screenshots</a></li>
    </ol>
  </li>
  <li><a href="/en-US/docs/Mozilla/Firefox_OS/Platform" title="Documentation about the Firefox OS platform, including Gonk, Gaia, and everything in between.">Firefox OS platform guide</a>
    <ol>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gaia" title="Documentation about Gaia, the user interface application for Firefox OS devices; this is a Web application running atop the Firefox OS software stack.">Gaia</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Gonk" title="Documentation about Gonk, the operating system layer underneath Gaia. This consists of a Linux kernel and a hardware abstraction layer to which Gecko communicates.">Gonk</a></li>
      <li><a href="/en-US/docs/Mozilla/Gecko" title="Gecko is the layer of Firefox OS that provides the same open web standards implementation used by Firefox and Thunderbird, as well as many other applications.">Gecko</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Security" title="Documentation about security in Firefox OS">&nbsp;Security</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Feature_support_chart" title="A chart of which features are available in which types of Firefox OS builds.">Feature support chart</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Architecture" title="An overview of how Firefox OS is structured internally; this is primarily of interest to platform developers and people doing porting work.">Firefox OS architecture overview</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Apps_architecture" title="An overview of the application model on Firefox OS.">Firefox OS apps architecture</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Settings_list" title="A list of common setting names that can be used with the settings API">Firefox OS settings list</a></li>
    </ol>
  </li>
  <li><a href="/en-US/docs/Mozilla/Firefox_OS/Building_and_installing_Firefox_OS" title="This includes documentation for building and installing the platform onto devices, as well as building the simulator and emulators.">Build and install Firefox OS</a>
    <ol>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Firefox_OS_build_prerequisites" title="Steps to take before you build Firefox OS for the first time.">Firefox OS build prerequisites</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Preparing_for_your_first_B2G_build" title="Before you can build Firefox OS, you need to clone the repository and configure your build.">Preparing for your first Firefox OS build</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Building" title="How to build Firefox OS.">Building Firefox OS</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Porting" title="Information about how to port Firefox OS to new devices.">Porting Firefox OS</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Choosing_how_to_run_Gaia_or_B2G" title="Using Gaia within Firefox, running Firefox OS on a mobile device, or in a desktop-based simulator. Whihc is best?">Choosing how to run Gaia or Firefox OS</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Using_Gaia_in_Firefox" title="How to use Gaia within a desktop Firefox browser.">Using Gaia in Firefox</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_desktop_client" title="Simulating the Gaia environment in a desktop application - more accurate than running Gaia in Firefox but not as accurate as the emulators.">Using the Firefox OS desktop client</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_B2G_emulators" title="A guide to building and using the Firefox OS emulators, and when to use which emulator.">Using the Firefox OS emulators</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Installing_on_a_mobile_device" title="How to install Firefox OS on a real mobile device.">Installing Firefox OS on a mobile device</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Dual_boot_of_B2G_and_Android_on_SGS2" title="How to set up a Firefox OS/Android dual boot environment on a Samsung Galaxy S2.">Dual boot of Firefox OS and Android on SGS2</a></li>
    </ol>
  </li>
  <li><a href="/en-US/docs/Mozilla/Firefox_OS/Hacking_Firefox_OS" title="Hack the OS, customize your builds, get things the way you think they should be!">Hacking Firefox OS</a>
    <ol>
      <li><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Tips_and_tricks/modifying_hosts_file" title="A guide to what can be achieved by modifying the Firefox OS hosts file.">Modifying the hosts file</a></li>
      <li><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Customization_with_the_.userconfig_file" title="How to customize the build and execution of Firefox OS by changing the .userconfig file.">Customization with the .userconfig file</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Platform/Testing" title="A guide to testing Firefox OS, including information about creating automated tests.">Testing Firefox OS</a></li>
      <li><a href="/en-US/docs/Firefox_OS/Hacking_Firefox_OS/Localizing_Firefox_OS" title="A guide to localising the Firefox OS platform, making it available in your preferred languages.">Localizing Firefox OS</a></li>
    </ol>
  </li>
  <li><a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide" title="A developer's guide to the Firefox OS developer phones available.">Firefox OS developer phone guide</a>
    <ol>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Developer_phone_guide/Updating_and_Tweaking_Geeksphone" title="tips on how to keep your Geeksphone up-to-date and how to tweak the system Gaia applications.">Updating and Tweaking your Firefox OS Developer Preview phone/Geeksphone</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Troubleshooting" title="A guide to resolving common problems with Firefox OS.">Troubleshooting</a></li>
    </ol>
  </li>
  <li><a href="/en-US/docs/Mozilla/Firefox_OS/Releases" title="This section of the site contains release notes, explaining what new features and changes of significance to developers have landed in each new release of Gaia and Gecko on Firefox OS.">Firefox OS release notes</a>
    <ol>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Releases/1.2">Firefox OS 1.2 for developers</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Releases/1.1HD">Firefox OS 1.1HD for developers</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Releases/1.1">Firefox OS 1.1 for developers</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Releases/1.0.1">Firefox OS 1.0.1 for developers</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/API_support_table">Firefox OS API support table</a></li>
      <li><a href="/en-US/docs/Web/Apps/App_permissions">App permissions</a></li>
    </ol>
  </li>
  <li><a href="#">Firefox&nbsp;OS app design and development</a>
    <ol>
      <li><a href="/en-US/docs/Web/Apps" title="/en-US/docs/Web/Apps">Apps zone</a></li>
      <li><a href="http://www.mozilla.org/en-US/styleguide/products/firefox-os/" title="This guide serves as a resource to designers and developers to help define the visual style for their Firefox OS apps.">Firefox OS visual design guidelines</a></li>
      <li><a href="https://developer.mozilla.org/en-US/docs/Mozilla/Firefox_OS/Apps/Tips_and_techniques" title="An assortment of tips and tricks (as well as workarounds for problems) that our developers have suggested for you!">Tips and techniques</a></li>
      <li><a href="https://marketplace.firefox.com/developers/" title="A collection of tools, tutorials, and services for Firefox OS app developers.">Developer Hub</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Debugging" title="A guide to debugging both your mobile apps and Firefox OS itself.">Debugging on Firefox OS</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Using_the_App_Manager" title="A tool that allows you to install open web apps from your computer to a device capable of installing them (such as Firefox OS) - and debug any running app.">Using the Firefox OS app manager</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Localizing_Firefox_OS_Apps" title="A handy guide to creating and managing localizations of your Firefox OS apps.">Localising Firefox OS Apps</a></li>
      <li><a href="/en-US/docs/Mozilla/Firefox_OS/Performance" title="Articles about optimizing Firefox OS applications.">Performance</a></li>
    </ol>
  </li>
</ol>
Revert to this revision