Repository Layout

Orientation map for the org.

Core repositories

Repo Contains

acreetionos

The flagship ISO builder: airootfs overlay, packages.x86_64 lists, mkarchiso plumbing, Calamares config, grub/syslinux setup, Recovery Environment sources, Changes.md engineering log

acreetionos-immutable

Image-style edition build (Immutable Edition)

acreetionos-mobile

Touch/mobile port work (Mobile Edition)

AcreetionMediaWriter

Cross-platform USB writer tool

acreetionos-code.github.io

Main website (acreetionos.org) — landing, downloads, community pages

docs (this site’s source)

Antora components powering docs.acreetionos.org

Inside the flagship repo (acreetionos/)

airootfs/            live-system overlay: configs, services, recovery units
packages.x86_64      the package manifest (heavily commented sections)
build.sh             orchestration entry point
mkarchiso*           modified archiso tooling
grub/ syslinux/      bootloader assets incl. recovery entries
installer/           calamares config + postinstall hooks
Changes.md           append-only engineering changelog (read for context!)
Issues/              historical triage notes

Branching culture

  • main = buildable truth

  • Feature branches short-lived; recovery-related work sometimes branches (historical recovery branch precedent) until proven

  • Tags mark shipped ISO builds — traceability from download page back to source state

Where YOUR change goes

Clone sizes stay modest; full ISO builds need no exotic infra (Building the AcreetionOS ISO).