GrapheneOS is an open source project with an open development process.
The GrapheneOS sources are hosted in the GrapheneOS organization on GitHub. Since there are many repositories, this page aims to provide a guide for it. See the reporting issues section on the contact page for an comparable overview of where issues should be filed.
The operating system source tree includes hundreds of repositories. Many of these are only used for debugging, testing or development and are not actually part of what gets used for building a production release. The manifest repository references all of these. Most of these are used unmodified from the Android Open Source Project (AOSP). A few dozen of the repositories including most of the core OS are either forked from AOSP or are unique to GrapheneOS.
The operating system has a unified build system, but some components like Chromium are too complex to fit into it so they're included as prebuilts instead of porting them to the AOSP build system. This is also done for developer convenience and bootstrapping, to avoid needing to build all the native / cross-compilation toolchains for each host and target platform combination, etc. The prebuilts can all be built from source if desired. The build instructions will be expanded to cover all of this in the future.
For a full list of the repositories in the OS source tree, look at the default.xml list in the manifest repository.
GrapheneOS forks of AOSP repositories:
- Manifest for OS repositories
Repositories added by GrapheneOS:
- Auditor prebuilt (platform_external_Auditor)
- PDF Viewer prebuilt (platform_external_PdfViewer)
- GrapheneOS fork of the open source Talkback and Switch Access accessibility services
- Vanadium prebuilt (platform_external_vanadium)
- OS update client (platform_packages_apps_Updater)
These are standalone app projects developed by GrapheneOS and included in the OS. This does not include the many apps included by AOSP without modifications by GrapheneOS or with only minor modifications.
An archive of legacy repositories is available via the GrapheneOS Archive organization. This only covers repositories archives after renaming the project to GrapheneOS. Earlier code is mostly not available via GitHub anymore due to the unfortunate events leading to the rename of the project.