This repository contains Flatpak build recipes of commonly shared modules and is intended to be used as a git submodule. Each submodule may include additional instructions to be used properly. Please check the folder containing that module to see if anything extra needs to be done.

To use shared modules for packaging an application, add the submodule:

git submodule add https://github.com/flathub/shared-modules.git

Then modules from this repository can be specified in an application manifest.

"modules": [
  "shared-modules/SDL/SDL-1.2.15.json",
]

And for a YAML manifest:

modules:
  - shared-modules/SDL/SDL-1.2.15.json

To update the submodule:

git submodule update --remote --merge

To automate updates, dependabot can be used but please limit the update frequency to not more than once or twice a week.

To remove the submodule:

git submodule deinit -f -- shared-modules
rm -rf .git/modules/shared-modules
git rm -f shared-modules
rm .gitmodules

We provide an automatic updating mechanism for submodules located here. In order to utilize it set up x-checker-data for your sources and they will be checked for updates in a weekly basis.

• The module must be widely used on Flathub by actively maintained applications.

• The module must not be provided by any current branch of the runtimes.

• The module manifest must be in JSON format.

Please open a pull request with the module manifest and add yourself as a codeowner of that module.

The manifest must be buildable with the latest Freedesktop SDK runtime.