Roadmap
Last updated: 2026-08-13 | Maintainer: tuna-os (hanthor) / architect agent
Mission
bootc-installer is the org's install UX front door: a GTK 4 / Libadwaita
Flatpak installer that guides a user from ISO to a booted, personalized
bootc image. The fisherman Go backend
executes a 9-step pipeline (partition → format → LUKS → mount → bootc install → post-install → Windows migration → finalize) from a single JSON
recipe, supporting both the systemd-boot/UKI stack (Dakota) and the GRUB2
stack (Bluefin, Bluefin-LTS, Bazzite).
Current Status (August 2026)
- Young, active repo: production Flatpak auto-released on every push to
dev(#5); TunaOS project-baseline CI adopted (#11, merged). - 9-step fisherman pipeline covers both boot stacks; Windows data migration (documents/photos/music/bookmarks/fonts/wallpapers) is a differentiator.
- ✅ The supply-chain issue this doc previously flagged as open —
FLATPAK_INDEX_TOKEN/GITHUB_TOKENembedded in git clone URLs — is fixed (#12, merged). Unit-test coverage has also grown substantially since this doc was first written (coverage gate raised across several PRs ondev). - Org context: per-desktop installers (
tuna-installer-cosmic|kde|niri|xfce) and Apple Silicon (bootc-installer-asahi) share this backend's concepts; parity between them is not yet tracked in this repo. - No milestones yet; work tracked ad-hoc via issues.
- ⚠️ This file previously lived only on the non-default
mainbranch (tunaos#1361) — landed here ondev, the repo's actual default branch, so it's visible from the repo root.
Priorities
| Priority | Item | Tracking | Status |
|---|---|---|---|
| P0 | Stop embedding FLATPAK_INDEX_TOKEN / GITHUB_TOKEN in clone URLs | #12 | ✅ Done |
| P0 | Live-ISO flow documented + tested end-to-end | docs/live-iso.md | 🟡 Docs exist |
| P1 | tuna-installer-* family parity — single backend, per-desktop skins | tunaos#1294 (context) | ⬜ Not started |
| P1 | E2E test plans for both boot stacks (systemd-boot + GRUB2) | docs/test-plans/ | 🟡 In progress |
| P2 | Windows migration QA matrix (Win10/11, FAT32/NTFS/exFAT) | docs/features/ | ⬜ Not started |
Quarterly Goals
Current Quarter (2026 Q3 — July–September)
Theme: Stable, token-safe install UX
| Goal | Owner | Tracking | Status |
|---|---|---|---|
| Land #12 token fix + verify no secrets in recipe/clone paths | sec-check | #12 | ✅ Done |
| Baseline CI green on both boot-stack test plans | ci-maintainer | #11 (baseline) | ✅ Baseline adopted; coverage gate rising |
| Publish install-UX guide for tunaos.org (download → installed) | guide | docs site | ⬜ Not started |
| Define tuna-installer-* parity contract (backend reuse) | architect | — | ⬜ Not started |
Next Quarter (2026 Q4 — October–December)
Theme: Enterprise-ready installs
- LUKS-first + dual-boot scenarios validated on Redfin/RHEL track (#1123)
- Signed Flatpak releases + SBOM aligned with org Q4 supply chain (#1187)
- Windows-migration QA matrix shipped; recovery/rollback path documented
- Installer telemetry hook (opt-in) feeding ADOPTION-METRICS.md install tier
Technical Debt Backlog
| Item | Issue | Priority | Effort |
|---|---|---|---|
Scratch-space constraints (/var/fisherman-tmp vs tmpfs /run) | README | P2 | S |
VERSION / recipe drift across tuna-installer-* forks | — | P2 | M |
| Single JSON recipe error-handling transparency | — | P3 | S |
How to Contribute
See CONTRIBUTING.md and AGENTS.md. The repo is small and well-scoped — good entry points: test-plan coverage for a boot stack, live-ISO docs, Windows-migration QA fixtures.
Roadmap Governance
Maintained by the strategist agent; updates after major milestones or quarterly. Propose changes via PR to this file with an issue reference.
Generated by strategist agent at ACMM L6 — full mode (ISSUES_AND_PRS).