README.md

aurora-common

Shared OCI layer containing configuration files for https://github.com/ublue-os/aurora.

This repo builds on top of:

• https://github.com/ublue-os/aurorafin-shared

• https://github.com/get-aurora-dev/branding

• https://github.com/ublue-os/artwork

• system_files/shared/ - Configuration shared between Aurora and Aurora-DX

• system_files/dx/ - Aurora-DX specific configuration

• wallpapers/ - Aurora wallpapers from artwork repo

• system_files/shared/usr/share/ublue-os/homebrew/ - Flatpak definitions used for including flatpaks for the ISOs and ujust install-system-flatpaks - Yes, homebrew supports the installation of Flatpaks

• logos/ - Aurora Logos used in PLM/Plasma Kickoff etc.

Related work is on the Fedora KDE-SIG

• kde-settings

Usage in Downstream Projects

Aurora images reference this layer in their Containerfiles:

FROM ghcr.io/get-aurora-dev/aurora-common:latest AS aurora-common

# Copy shared configuration
COPY --from=aurora-common /system_files/shared /

# Copy DX-specific configuration (Aurora-DX only)
COPY --from=aurora-common /system_files/dx /

# Copy wallpapers
COPY --from=aurora-common /wallpapers /

# Copy other assets as needed
COPY --from=aurora-common /logos /tmp/logos

Verify authenticity with cosign

cosign.pub has been used in the past to sign artifacts, we are using keyless OIDC signing now.

cosign verify \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com \
  --certificate-identity-regexp="github.com/get-aurora-dev/common/.github/workflows/*" \
  ghcr.io/get-aurora-dev/common:latest

Building Locally

just build

Additional Commands

# Check Just syntax
just check

# Fix Just formatting
just fix

# Inspect image structure
just tree

# Dump image contents to ./dump
just dump