[Build] Implement Flathub publishing for Linux (post-beta) — per ADR-003
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- Over a week
- Newbie friendliness
- 35/100
- Issue type
- Feature
- Clarity
- Clearly specified
- Activity status
- Quiet
- Tech stack
- dart, linux
- Domain
- build-system, desktop, release
Research direction
Start with docs/adr/003-linux-native-distribution-channel.md and ROADMAP 7.1 to confirm the distribution decision and post-beta timing. Then inspect the release assets and the app's beta.json/stable.json update check; implement the manifest, metainfo, desktop entry, icons, and Flatpak-aware banner behavior described here. Done means the acceptance criteria pass and the Flathub listing is live with store-managed updates.
Written by the indexing model from the issue text.
Description
Implementation follow-up to the ADR-003 decision (evaluation in #306): publish Caller's Compendium to Flathub as the first native Linux distribution channel, post-beta.
Blocked-until: post-beta (see ROADMAP 7.1). This is deliberately deferred; the beta ships fine on the GitHub Releases AppImage/tar.gz baseline.
Scope (from ADR-003)
- Author the Flatpak manifest
org.callerscompendium.compendiumApp.yml(freedesktop runtime; source the published, checksum-verified…-linux-x64.tar.gzrelease asset), plus AppStream metainfo, a.desktopentry, and icons. - Keep the sandbox tight: minimal
finish-args, prefer XDG desktop portals for the file chooser and printing over broad--filesystemaccess. - Submit to Flathub (
flathub/flathubPR fororg.callerscompendium.compendiumApp); pass review. - Release automation: bump the pinned tag +
sha256on each GitHub Release (or wire Flathub's update bot) so Flathub rebuilds from the verified tarball. - App code: make the in-app update check Flatpak-aware — detect running-under-Flatpak (
FLATPAK_ID//.flatpak-info) and suppress/soften the Stage-1 update banner so Flathub users aren't told to hand-download an AppImage. Non-Flatpak installs keep the existingbeta.json/stable.jsoncheck.
Acceptance criteria
- A Flatpak build installs and runs on a clean Flatpak host with working import/export, backup, and printing (via portals).
- Flathub listing live under
org.callerscompendium.compendiumApp; store-managed updates work. - Under Flatpak, the app does not show the AppImage-download update banner; direct-download installs are unchanged.
Refs #306, ADR-003.
- Dominant language
- Dart
- Stars
- 0
- Forks
- 0
- Avg merge
- 2h 59m
- Merged PRs (30d)
- 469
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from ibanner56/CallersCompendium
-
area: import priority: low severity: minor type: bug
Difficulty 4/5 3-5 days Newbie friendliness 35/100
ibanner56/CallersCompendium#1976 · 2 comments ·
Maintainers usually reply within 1 day
-
area: import area: taxonomy priority: medium severity: minor status: backlog type: enhancement
Difficulty 5/5 Over a week Newbie friendliness 25/100
ibanner56/CallersCompendium#1975 · 3 comments ·
Maintainers usually reply within 1 day
-
area: export area: import status: blocked type: chore
Difficulty 4/5 3-5 days Newbie friendliness 25/100
ibanner56/CallersCompendium#1885 ·
Maintainers usually reply within 1 day
-
area: import area: sync stable status: backlog type: enhancement type: experimental
Difficulty 5/5 Over a week Newbie friendliness 25/100
ibanner56/CallersCompendium#1423 ·
Maintainers usually reply within 1 day
-
area: dance_entry priority: low stable status: in-progress type: enhancement type: experimental
Difficulty 5/5 Over a week Newbie friendliness 25/100
ibanner56/CallersCompendium#1031 ·
Maintainers usually reply within 1 day
All issues in ibanner56/CallersCompendium
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 64/100
bannzai/medicalarm#478 ·
Maintainers usually reply within 1 day
-
genkit_anthropic: responses with an empty or unknown usage.service_tier fail with FormatException: Unknown ServiceTierPossibly taken @kenzieschmoll claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
genkit-ai/genkit-dart#686 ·
Maintainers usually reply within 3 days
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
aaronified/fluenough#918 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
VeryGoodOpenSource/very_good_analysis#255 ·
Maintainers usually reply within 1 day