reference-browser

What Reference Browser is for

Reference Browser is a web browser reference implementation that uses Mozilla Android Components. The README is explicit that it is not a product intended to ship to end users. Instead it is a technology preview for many new mobile components that several Mozilla teams are working on. It includes the Mozilla Web Platform through GeckoView, a modern Firefox Accounts and Cloud Sync implementation, and the Glean telemetry library. The README states that all of these components will be foundational for Mozilla's existing and upcoming Android products. The browser can also serve as a starting point for your own browser like applications, and it depends heavily on the Android Components project where most of the actual implementation lives. That project also includes many smaller sample applications. By living outside the main Mozilla source tree, Reference Browser lets the team see how core browsing APIs work for projects outside Firefox, provides a developer playground for experimental APIs with a full build and signing process, and validates that the Maven repositories and Google Play publishing pipeline still function. It is a living test bed rather than a daily driver for ordinary users. By validating the Maven and Play publishing paths, the browser acts as an early warning system: if those pipelines break, the broken nightly build shows the problem before shipping products notice.

Building and local development

For developers, Reference Browser supports an auto publication workflow that automates dependency publication for android components and application services. You specify relative paths to local checkouts in a local.properties file, and the next build of Reference Browser uses those local versions, so changes made in android components or application services are picked up when you run the app. A separate path configures GeckoView through a dependency substitution, pointing to a local mozilla central source and object directory after you have built and packaged your own GeckoView. The README reminds you to run a Gradle sync in Android Studio after changing local.properties so substitutions appear in the module list. Nightly builds are published and can be downloaded directly as signed APKs for ARM64, ARM, and x86_64 devices on Android 8 or newer, though the README notes these builds do not auto update and must be kept current manually. There is also a Google Play test channel that requires joining a Google Group and then the test program with the same Google account. These paths make the browser useful for testing components against real builds on physical hardware. The auto publication workflow means a change in android components is reflected the next time Reference Browser builds, so component authors get fast feedback without publishing to Maven first.

Contributing and licensing

The project encourages outside participation and states that it welcomes pull requests, bug reports, ideas, security code reviews, and any kind of positive contribution. Before contributing, the README asks readers to read Mozilla's Community Participation Guidelines. It links to the current issues and pull requests, a list of good first issues for new contributors, and a list of help wanted issues. Communication happens on IRC in the android components channel, with public logs, and through a mailing list for android components. The license section states that the source code form is subject to the terms of the Mozilla Public License, version 2.0, and that a copy can be obtained from the Mozilla site if one was not distributed with the file. As a Mozilla project, the browser functions as a living validation harness for the Android Components stack and a place where experimental APIs can be exercised in a full app before they reach Firefox and other shipping products. Its value is less as a finished browser and more as a reference and test bed for the underlying platform that powers Mozilla's Android efforts. The README also links a list of help wanted issues for contributors who want a larger task, and it keeps IRC logs public so discussions are searchable after the fact.

Editorial conclusion

Reference Browser is distributed under the Mozilla Public License 2.0 and, at the time of writing, the repository recorded 663 stars and was last updated on 2026-08-24.