WhereAmI Flatpak

This repository has one entry point. Both modes create:

io.github.rubiojr.whereami.flatpak

Build the local WhereAmI checkout, including uncommitted changes:

./build dev ../whereami

The source directory defaults to .., so this is equivalent when the Flatpak repository is nested inside the WhereAmI checkout:

./build dev

Test the bundle:

flatpak install --user --reinstall io.github.rubiojr.whereami.flatpak
flatpak run --user io.github.rubiojr.whereami

The bundle points Flatpak at Flathub for its KDE runtime dependency.

After tagging WhereAmI, build that exact tag from a clean checkout:

./build release v0.1.12 ../whereami

Release mode refuses to build when:

• the WhereAmI checkout is dirty;
• the tag does not exist; or
• the tag is not checked out at HEAD.

Test the resulting bundle with the same flatpak install --reinstall command. Uploading it to GitHub Releases is a separate manual step after validation.

./build runs the complete build in a disposable Fedora 44 Podman container. The packaging and application checkouts are mounted read-only, and only the finished bundle is copied back to the packaging checkout. The container regenerates Flatpak Go dependency sources before invoking flatpak-builder. Development mode uses the dirty local source; release mode uses the exact tagged Git source. Generated dependency metadata is temporary and never modifies either checkout.

Development builds reuse the Podman volume whereami-flatpak-f44-kde69-$HOSTTYPE for Flatpak runtimes, downloaded Go modules, flatpak-builder state, and ccache. Release builds do not mount this volume and always use disposable build state. Remove the development cache with:

podman volume rm "whereami-flatpak-f44-kde69-$HOSTTYPE"

MapLibre Native Qt is built inside the Flatpak against the pinned KDE/Qt runtime. Its commit is pinned in maplibre-native-qt.yml because its QtLocation plugin links Qt private APIs.

Requirement: rootless Podman. The container installs all build dependencies itself and needs network access to Fedora, Flathub, GitHub, and the Go module proxy.

The packaging files are MIT licensed; see LICENSE. The bundle also includes:

WhereAmI distributes the MapLibre Location component under LGPL-3.0-only. The exact MapLibre source commit and build configuration are recorded in maplibre-native-qt.yml, and the libraries are dynamically linked. Upstream license texts and notices are installed under /app/share/licenses/io.github.rubiojr.whereami/.