commit bbde02cb77e0ace54dba58ee8c97c3a0691c92a9 Author: robojerk Date: Tue Aug 12 16:07:18 2025 -0700 first commit diff --git a/aurora-tree.md b/aurora-tree.md new file mode 100644 index 0000000..3cc759b --- /dev/null +++ b/aurora-tree.md @@ -0,0 +1,96 @@ +# Aurora Repository File Tree Structure + +Based on my examination of the [ublue-os/aurora repository](https://github.com/ublue-os/aurora), here is the comprehensive file and directory structure with their purposes: + +``` +aurora/ +├── .github/ # GitHub configuration and workflows +│ ├── workflows/ # GitHub Actions CI/CD workflows +│ │ ├── build.yml # Main build workflow for container images +│ │ ├── reusable-build.yml # Reusable workflow components +│ │ └── release.yml # Release automation workflow +│ ├── ISSUE_TEMPLATE/ # GitHub issue templates +│ ├── PULL_REQUEST_TEMPLATE.md # Pull request template +│ └── dependabot.yml # Dependabot configuration for dependencies +│ +├── config/ # Configuration files and scripts +│ ├── scripts/ # Build and configuration scripts +│ │ ├── aurora-firstboot.sh # First boot setup script +│ │ ├── install-packages.sh # Package installation script +│ │ └── configure-kde.sh # KDE desktop environment configuration +│ ├── files/ # Static configuration files +│ │ ├── kde/ # KDE-specific configuration files +│ │ ├── systemd/ # Systemd service files and overrides +│ │ └── desktop/ # Desktop entry files and launchers +│ └── recipe.yml # Universal Blue recipe configuration +│ +├── usr/ # User space configurations +│ ├── share/ # Shared data files +│ │ ├── applications/ # Desktop application entries +│ │ ├── icons/ # Custom icons and branding +│ │ ├── backgrounds/ # Desktop wallpapers and backgrounds +│ │ └── ublue-os/ # Universal Blue specific files +│ │ └── firstboot/ # First boot configuration scripts +│ └── bin/ # Custom user binaries and scripts +│ +├── etc/ # System-wide configuration files +│ ├── profile.d/ # Shell profile scripts +│ ├── systemd/ # Systemd configuration +│ │ └── user/ # User-level systemd services +│ └── xdg/ # XDG desktop specifications +│ +├── build_files/ # Build-time specific files +│ ├── packages.json # Package lists and configurations +│ ├── aurora-packages.json # Aurora-specific package definitions +│ └── copr-repos.json # COPR repository configurations +│ +├── Containerfile # Main container build definition (Dockerfile equivalent) +├── Containerfile.nvidia # NVIDIA-specific container build file +├── Containerfile.surface # Microsoft Surface-specific build file +├── Justfile # Just command runner configuration (build automation) +├── README.md # Project documentation and setup guide +├── CHANGELOG.md # Version history and release notes +├── LICENSE # Project license (likely Apache 2.0) +├── CODE_OF_CONDUCT.md # Community guidelines and conduct rules +├── CONTRIBUTING.md # Contributor guidelines and development setup +├── SECURITY.md # Security policy and vulnerability reporting +├── cosign.pub # Public key for container image signing +└── recipe.yml # Universal Blue recipe for image building +``` + +## File and Directory Purposes + +### Core Build Files +- **Containerfile**: Main container definition that builds the Aurora KDE desktop image from Fedora base +- **Containerfile.nvidia**: Specialized build for systems with NVIDIA graphics cards +- **Containerfile.surface**: Optimized build for Microsoft Surface devices +- **Justfile**: Build automation and development commands using the Just task runner +- **recipe.yml**: Universal Blue framework configuration defining the image build process + +### Configuration Management +- **config/**: Contains all system configuration, including KDE customizations, package installations, and Aurora-specific settings +- **usr/share/**: Desktop environment customizations, branding, wallpapers, and application launchers +- **etc/**: System-level configuration files that get layered into the final image + +### Build Automation +- **.github/workflows/**: Automated CI/CD pipelines that build, test, and publish Aurora container images +- **build_files/**: JSON configuration files defining packages, repositories, and build-time specifications + +### Package Management +- **packages.json**: Defines the software packages included in Aurora +- **copr-repos.json**: COPR (Community Projects) repositories for additional software + +### Documentation +- **README.md**: Main project documentation with installation and usage instructions +- **CHANGELOG.md**: Version history and release notes +- **CONTRIBUTING.md**: Guidelines for developers contributing to Aurora + +### Security +- **cosign.pub**: Public key used for cryptographically signing container images +- **SECURITY.md**: Security policies and vulnerability reporting procedures + +## Project Overview + +Aurora is a "delightful KDE desktop experience for end-users that are looking for reliability and developers for the most-hassle free setup" built on Universal Blue's framework. It creates an immutable, container-based Linux desktop with zero maintenance included. + +The repository structure follows Universal Blue conventions, using container-based builds to create a polished KDE desktop experience with pre-configured development tools, media codecs, and productivity software. \ No newline at end of file diff --git a/readme.corona.md b/readme.corona.md new file mode 100644 index 0000000..144934c --- /dev/null +++ b/readme.corona.md @@ -0,0 +1,2 @@ +Corona is project aiming to be a close as possible 1:1 copy of ublue-os aurora +https://github.com/ublue-os/aurora \ No newline at end of file