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
OverSu 200d1fb235 Release Android Preview 21 and bilingual changelog
Add permission-based reading of Android contacts, SMS and call history. Include shared Gaia fixes and document device validation limits. Pixel image qualification remains pending.
2026-10-14 13:13:46 +02:00
adapters Publish Vulpes Preview 15 sources for desktop, Android and Tundra 2026-09-30 23:13:03 +02:00
android Release Android Preview 21 and bilingual changelog 2026-10-14 13:13:46 +02:00
assets Release Android Preview 21 and bilingual changelog 2026-10-14 13:13:46 +02:00
docs/media Use the current Vulpes logo in both READMEs 2026-09-30 23:36:42 +02:00
gaia Release Android Preview 21 and bilingual changelog 2026-10-14 13:13:46 +02:00
host Release Android Preview 21 and bilingual changelog 2026-10-14 13:13:46 +02:00
overrides Release Android Preview 21 and bilingual changelog 2026-10-14 13:13:46 +02:00
services Release Preview 20 shared desktop, Android and Sargo updates 2026-10-13 00:19:45 +02:00
tests Release Android Preview 21 and bilingual changelog 2026-10-14 13:13:46 +02:00
tools Release Android Preview 21 and bilingual changelog 2026-10-14 13:13:46 +02:00
tundra Release Preview 20 shared desktop, Android and Sargo updates 2026-10-13 00:19:45 +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 Release Android Preview 21 and bilingual changelog 2026-10-14 13:13:46 +02:00
changelog.json Release Android Preview 21 and bilingual changelog 2026-10-14 13:13:46 +02:00
CHANGELOG.md Release Android Preview 21 and bilingual changelog 2026-10-14 13:13:46 +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 Release Preview 20 shared desktop, Android and Sargo updates 2026-10-13 00:19:45 +02:00
package.json Release Preview 20 shared desktop, Android and Sargo updates 2026-10-13 00:19:45 +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 Release Preview 20 shared desktop, Android and Sargo updates 2026-10-13 00:19:45 +02:00
README.md Release Preview 20 shared desktop, Android and Sargo updates 2026-10-13 00:19:45 +02:00
release.json Release Android Preview 21 and bilingual changelog 2026-10-14 13:13:46 +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 20 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 Gaia home screen Gaia Settings, system information screen

Gaia home screen and Settings · screenshots from 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.

Preview 20 · 13 October 2026

Download the APK. Shared updates cover Gaia settings, camera recording, contacts and media. Native network changes are included in the sources. See the changelog for checks and remaining limitations.

Desktop/Sargo use Gecko 156.0.1; Android uses GeckoView 156.0. Android 8 / API 26 minimum is declared; not every device is tested. Calls and SMS open Android applications. The APK is a signed development build, with debugging through authorized ADB.

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.