An experimental community continuation of the Firefox OS / Boot to Gecko adventure. The Gaia mobile experience, brought up to date on a modern Gecko engine. https://vulpes-os.org
  • JavaScript 79%
  • HTML 8.7%
  • CSS 8.1%
  • Python 3.6%
  • Mustache 0.2%
  • Other 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-08 22:05:49 +02:00
adapters Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00
android Update shared Gaia workflows and Sargo development tooling 2026-10-08 14:27:17 +02:00
assets Update shared Gaia workflows and Sargo development tooling 2026-10-08 14:27:17 +02:00
docs/media Use the current Vulpes logo in both READMEs 2026-09-30 23:36:42 +02:00
gaia Update shared Gaia workflows and Sargo development tooling 2026-10-08 14:27:17 +02:00
host Update shared Gaia workflows and Sargo development tooling 2026-10-08 14:27:17 +02:00
overrides Update shared Gaia workflows and Sargo development tooling 2026-10-08 14:27:17 +02:00
services Update shared Gaia workflows and Sargo development tooling 2026-10-08 14:27:17 +02:00
tests Update shared Gaia workflows and Sargo development tooling 2026-10-08 14:27:17 +02:00
tools Automate bilingual changelog generation before publication 2026-10-08 18:46:39 +02:00
tundra Update shared Gaia workflows and Sargo development tooling 2026-10-08 14:27:17 +02:00
.gitignore Update shared Gaia workflows and Sargo development tooling 2026-10-08 14:27:17 +02:00
.nvmrc Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00
.prettierignore Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00
.prettierrc.json Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00
CHANGELOG.en.md Show Gaia home and Settings screenshots in both changelogs 2026-10-08 22:05:49 +02:00
changelog.json Show Gaia home and Settings screenshots in both changelogs 2026-10-08 22:05:49 +02:00
CHANGELOG.md Show Gaia home and Settings screenshots in both changelogs 2026-10-08 22:05:49 +02:00
engine-lock.json Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00
LICENSE Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00
NOTICE Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00
package-lock.json Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00
package.json Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00
pyproject.toml Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00
README.fr.md Add Settings screenshot to changelogs and fix README language links 2026-10-08 21:53:22 +02:00
README.md Add Settings screenshot to changelogs and fix README language links 2026-10-08 21:53:22 +02:00
release.json Update shared Gaia workflows and Sargo development tooling 2026-10-08 14:27:17 +02:00
requirements-dev.txt Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00
run.sh Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00
setup.sh Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00

English · Français

Vulpes OS

Vulpes OS

Firefox OS fork · Open source

Vulpes: 2.7 Preview 17 Gaia: 2.7 Gecko: 156.0.1 Tundra: 0.1.0

Android APK: Available Desktop: Available Native image: In development Pixel 3a: Bootable and usable

Website · Downloads · Changelog · Report a bug

Vulpes OS picks up where Firefox OS left off, adapting Gaia, its interface and HTML/CSS/JavaScript applications, to run on a recent Gecko engine.

I’m OverSu, and I develop Vulpes mostly on my own, with help from people who test and contribute to the project. Vulpes is free and open source, and will stay that way. There are no plans for subscriptions or paid features.

The Vulpes OS Gaia home screen running on desktop

The Gaia home screen in the desktop version.

Try Vulpes

Platform How to use it
Linux Run Gaia from source to explore the interface or develop applications.
Android Install the APK from the releases page. It runs as an Android application and does not replace your phone’s operating system.
Google Pixel 3a · Sargo Run Vulpes as a native operating system with Tundra. A downloadable image is still being prepared; see the device page for tested features and known limitations.

On the Pixel 3a, Tundra boots Gecko and Gaia directly and provides access to the hardware. Droidian was used as a testing environment early in development. It is not included in Vulpes OS, and Tundra is not based on it.

Linux

You’ll need Linux x86_64, Git, Python 3 and the system libraries required by Firefox.

git clone https://nnsprod.com/git/oversu/VulpesOS.git
cd VulpesOS
./setup.sh
./run.sh

setup.sh downloads the Gecko engine selected for this version and verifies its checksum.

Build the APK

From the repository root:

cd android
./build-apk.sh

The development APK is created in android/dist/. A personal build uses its own signing key, so it cannot update an APK signed with the project’s key.

Contribute

You can test Vulpes, report an issue, improve translations or contribute code. When reporting a bug, include your platform, the version you’re using and the steps to reproduce it.

Development updates and test results are in the changelog. If you’d like to help cover project costs, the Support me page explains what your contribution supports.

Credits and licenses

Thanks to Mozilla, Gaia contributors, Capyloon, Droidian, UBports, libhybris, Debian and AOSP for the code, tools and work that have helped this project.

New Vulpes code is licensed under MPL 2.0. Gaia retains its Apache 2.0 license; other components retain their own licenses and notices. See LICENSE, NOTICE and Gaia’s license.

Vulpes OS is an independent project by OverSu / NNS Production, with no affiliation with Mozilla.