Flatpak Remotes On GitHub Pages Automation Kit: publish your apps as a signed Flatpak remote, served by GitHub Pages. No server needed.
A FrogPak deployment is called a Pond: one GitHub repository that collects your apps' release bundles, builds a signed Flatpak repository from them, and publishes it with a landing page. People add your remote once and install and update your apps like any other Flatpak.
- Signed with your own key; Flatpak verifies every download.
- Apps come from their GitHub releases, built however you like. The optional FrogPak releaser builds and releases them for you.
- Checks for new releases hourly and rebuilds only when something changed; apps can trigger an update the moment they release.
- A landing page with install commands, your logo and colors, in light and dark mode, and each app's version, release date and license.
- Badges for app READMEs: a "Get it on" button for the Pond and a version badge for each app.
Use the Pond template, then follow Setting up a Pond.
- Setting up a Pond
- Configuration reference
- Feeding a Pond
- Security
- Troubleshooting
- Maintaining the engine
.github/workflows/publish-pond.yml: the reusable workflow Ponds call.frogpak/: the engine (python3 -m frogpak check | poll | publish).frogpak/sources/has one module per forge, and nothing outside it may assume a forge.tests/: unit tests andlocal_publish.py, which runs a full publish offline from a folder of bundles. Maintaining the engine has the commands and what they need.
FrogPak's mascot is the golden mantella (Mantella aurantiaca), a tiny orange frog found only in a few small areas of forest and wetland in eastern Madagascar. It is listed as Endangered: its habitat is being lost to logging, mining and farming, and collection for the pet trade adds to the pressure. Chester Zoo and its partner Madagasikara Voakajy work to protect it in the wild. Please consider a donation if it is within your means.
GPL-3.0-or-later. Ponds created from the template, and the apps they publish, are not covered by it.
The forge icons on Source links are from Simple Icons, CC0-1.0; the names and logos belong to their owners.