Files
omarchy-sc/GIT_DISTRIBUTION.md
2026-08-31 18:32:28 +02:00

1.6 KiB

Omarchy Citizen als Git-Plugin veröffentlichen

Für automatische Plugin-Updates sollte Omarchy Citizen als normales öffentliches Git-Repository veröffentlicht werden. manifest.json muss im Repository-Root liegen.

Repository-Inhalt

Den kompletten Inhalt dieses Ordners in das Repository übernehmen, einschließlich:

manifest.json
BarWidget.qml
Panel.qml
citizenctl
support-sanitize.py
backend/

Insbesondere sollte backend/bin/omarchy-citizen-backend mit eingecheckt werden, damit Nutzer keine Go-Toolchain benötigen.

Installation beim Nutzer

Sobald die Repository-URL feststeht:

omarchy plugin add https://github.com/DEIN-ACCOUNT/omarchy-citizen.git --enable --yes

Danach erkennt das Go-Backend origin automatisch. Im Plugin kann der Nutzer unter Erweiterte Optionen → Plugin-Updates → Auto-Updates einschalten einmalig zustimmen.

Ab diesem Zeitpunkt prüft der systemd-User-Timer etwa alle sechs Stunden. Bei einem Update ruft das Backend Omarchys eigenen nicht-interaktiven Plugin-Updater auf.

Release-Ablauf

Vor jedem Commit/Release:

./tests/verify.sh
omarchy plugin validate .

Die GitHub-Actions-Datei .github/workflows/ci.yml führt dieselben Kernprüfungen automatisch bei Push und Pull Request aus.

Dann Versionsnummern in manifest.json, citizenctl, Go-Backend und Dokumentation synchron halten, committen und pushen.

Tags/Releases sind für den Updater nicht zwingend erforderlich: Omarchy aktualisiert den Git-Checkout per Fast-Forward auf dessen Upstream-Branch. Für nachvollziehbare Versionen sind Git-Tags trotzdem empfehlenswert.