Read-only pull mirror of github.com/get-aurora-dev/common: Aurora's wallpapers, logos and shared files, which Aurora's build copies from its image.
Find a file
James Reilly 447fa91e92
init
2025-11-25 12:00:24 +05:30
.github init 2025-11-25 12:00:24 +05:30
brew feat: Introduce initial Aurora OS configuration, branding assets, and system components across various directories. 2025-11-25 11:59:55 +05:30
flatpaks feat: Introduce initial Aurora OS configuration, branding assets, and system components across various directories. 2025-11-25 11:59:55 +05:30
just feat: Introduce initial Aurora OS configuration, branding assets, and system components across various directories. 2025-11-25 11:59:55 +05:30
logos feat: Introduce initial Aurora OS configuration, branding assets, and system components across various directories. 2025-11-25 11:59:55 +05:30
system_files feat: Introduce initial Aurora OS configuration, branding assets, and system components across various directories. 2025-11-25 11:59:55 +05:30
.gitattributes init 2025-11-25 12:00:24 +05:30
.gitignore init 2025-11-25 12:00:24 +05:30
.pre-commit-config.yaml init 2025-11-25 12:00:24 +05:30
AGENTS.md init 2025-11-25 12:00:24 +05:30
Containerfile init 2025-11-25 12:00:24 +05:30
Justfile init 2025-11-25 12:00:24 +05:30
LICENSE init 2025-11-25 12:00:24 +05:30
README.md init 2025-11-25 12:00:24 +05:30

bluefin-common

Shared OCI layer containing common configuration files used across all Bluefin variants (bluefin, bluefin-dx, bluefin-lts).

What's Inside

This layer contains two main configuration directories:

/etc/ublue-os/ - System Configuration

  • Bling - CLI theming settings
  • Fastfetch settings - System information display configuration
  • Setup configuration - First-boot and system setup parameters

/usr/share/ublue-os/ - User-Space Configuration

  • Firefox defaults - Pre-configured Firefox settings
  • Flatpak overrides - Application-specific Flatpak configurations
  • Just recipes - Additional command recipes for system management
  • MOTD templates - Message of the day and tips
  • Setup hooks - Scripts for privileged, system, and user setup stages

Usage in Containerfile

Reference this layer as a build stage and copy the directories you need:

Copy everything:

FROM ghcr.io/ublue-os/bluefin-common:latest AS bluefin-common

# Copy all system files
COPY --from=bluefin-common /system_files /

Copy only system configuration:

This is what Aurora should use, gives shares the common set of files and keeps the images opinions seperate.

FROM ghcr.io/ublue-os/bluefin-common:latest AS bluefin-common

# Copy only /etc configuration
COPY --from=bluefin-common /system_files/etc /etc

Copy only the image opinion:

FROM ghcr.io/ublue-os/bluefin-common:latest AS bluefin-common

# Copy only /usr/share configuration
COPY --from=bluefin-common /system_files/usr /usr

Building Locally

just build