@@ -1,22 +1,27 @@
1−This is where the magic happens.
1+# Flathub
3−Application manifests should go in their own branches, named after the application ID.
3+Flathub is the central place for building and hosting Flatpak builds.
5−For example, for gnome-recipes, there is a branch named org.gnome.Recipes which has
5+Using the Flathub repository
6−the org.gnome.Recipes.json file at the toplevel.
6+----------------------------
8−The manifests should build releases, not development snapshots, so please use
8+To install applications that are hosted on Flathub, use the following:
9−tarballs or git tags, not just the tip of a branch.
9+```
10+flatpak remote-add flathub https://flathub.org/repo/flathub.flatpakrepo
11+flatpak install flathub org.gnome.Recipes
11−In case you build from a git tag, please specify both the tag name and the commit id, liks so:
14+To install applications from the beta branch, use the following:
13− "branch": "1.0.4",
16+flatpak remote-add flathub-beta https://flathub.org/beta-repo/flathub-beta.flatpakrepo
14− "commit": "cdfb19b90587bc0c44404fae30c139f9ec1cca5c"
17+flatpak install flathub-beta org.godotengine.Godot
16−This makes the build repeatable, since a tag can otherwise change its value over time.
17−You can also use only a commit, but specifing a tag name if there is one is good for readability.
19−Flathub always builds in the flatpak branchname "stable", and it always passes --default-name=stable,
20+For more information and more applications see https://flathub.org
20−so you don't need to specify a branch key. But if you do (not recommended), it must be "stable".
21+
22+Contributing to Flathub
23+-----------------------
25+For information on creating packages or reporting issues please see the [contributing page](/CONTRIBUTING.md).
22−All applications in flathub should ship with appstream data.
27+***Note:*** *this repository is not for reporting issues related to the flathub.org website itself or contributing to its development. For that, go to https://github.com/flathub/website*