On this PR the Kolibri developers were surprised to learn that functionality specific to the Flatpak version of the app should not be developed in the repository on Flathub. Specifics of this case aside, I don’t think there is any good reference for what should or should not live in the Flathub Git repo. My understanding is:
.jsonmanifest, plus 0 or more other manifests it imports (perhaps from
flathub.jsonto disable some architectures and set various Flathub-infra-specific flags
Acceptable but should be submitted upstream
- Patches necessary to build and run the application in the Flatpak environment (I include Zypak here)
.desktopand other metadata required for Flathub apps but not shipped by some (primarily cross-platform) applications
- Patches which add new functionality
I think the closest we have to documenting this is the App Requirements page but that is more about what to include, not what not to include.