@@ -1 +1,27 @@
1−This is where the magic happens.
1+# Flathub
2+
3+Flathub is the central place for building and hosting Flatpak builds.
4+
5+Using the Flathub repository
6+----------------------------
7+
8+To install applications that are hosted on Flathub, use the following:
9+```
10+flatpak remote-add flathub https://flathub.org/repo/flathub.flatpakrepo
11+flatpak install flathub org.gnome.Recipes
12+```
13+
14+To install applications from the beta branch, use the following:
15+```
16+flatpak remote-add flathub-beta https://flathub.org/beta-repo/flathub-beta.flatpakrepo
17+flatpak install flathub-beta org.godotengine.Godot
18+```
19+
20+For more information and more applications see https://flathub.org
21+
22+Contributing to Flathub
23+-----------------------
24+
25+For information on creating packages or reporting issues please see the [contributing page](/CONTRIBUTING.md).
26+
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*