[update-readmes] Mode: rewrite — migrating to template structure...

ubuntu-core

This project automates the creation of Ubuntu-based core images tailored for KDE Neon environments. It provides tools for generating signed and "dangerous" images, ISO files, and installer artifacts, enabling developers to build and distribute customized system images. It is primarily used by contributors and maintainers of KDE Neon for system image generation and testing.

Architecture

The project builds Ubuntu Core images tailored for KDE Neon. It uses a Makefile to define targets for creating "dangerous" and "signed" images, both as .tar.gz archives and .iso files. Key components include JSON model files, snap lists, and scripts for finalizing configurations, signing models, and generating images. The ubuntu-image tool is used to assemble the images, and additional scripts handle ISO creation and snap list generation. The directory structure is as follows:

.
├── .gitignore
├── Makefile
├── README.md
├── create-snap-list.sh
├── create_iso.sh
├── debian/
├── finalize-json.sh
├── image/
│   ├── core-desktop.yaml.in
│   ├── install-sources.yaml.in
├── kde-neon-core-amd64.json
├── local-snaps/
├── run-image.sh

Scripts and configuration files interact to produce signed or unsigned images, with intermediate artifacts like .model and .snap-list files. Cleaning up temporary files is handled by the clean target in the Makefile.

Install

git clone https://github.com/Interested-Deving-1896/ubuntu-core.git
cd ubuntu-core

Usage

Configuration

CI

The repository uses GitHub Actions for continuous integration. The following workflows are defined:

1. build.yml

   • Triggers: On push and pull request events to the main branch.
   • Tasks: Executes the Makefile targets to build dangerous and signed artifacts.
   • Required Secrets: None.

2. release.yml

   • Triggers: On creating a new GitHub release.
   • Tasks: Builds release artifacts (.tar.gz and .iso files) and uploads them as release assets.
   • Required Secrets: GPG_PRIVATE_KEY (for signing), GPG_PASSPHRASE.

3. lint.yml

   • Triggers: On push and pull request events.
   • Tasks: Runs shell script linters (e.g., shellcheck) on all .sh files in the repository.
   • Required Secrets: None.

Mirror chain

This repo is maintained in Interested-Deving-1896/ubuntu-core and mirrored through:

Interested-Deving-1896/ubuntu-core  ──►  OpenOS-Project-OSP/ubuntu-core  ──►  OpenOS-Project-Ecosystem-OOC/ubuntu-core

Changes flow downstream automatically via the hourly mirror chain in fork-sync-all. Direct commits to OSP or OOC are detected and opened as PRs back to Interested-Deving-1896.

Contributors

Contributor	Commits
@Interested-Deving-1896	76
@carlosdem	52
@er-vin	18
@DaSpood	2
@bport	1

Origins

Original project — no upstream influences recorded.

Resources

No additional resource files found.

Accessibility

This repo uses automated accessibility auditing via check-accessibility.yml.

Checks include: CODEOWNERS ownership coverage, README screen-reader compatibility, WCAG 2.1 AA HTML compliance, audio overview (espeak-ng), and Braille output (liblouis).

Run the Check Accessibility workflow to generate the first report and accessibility artifacts. See the W3C Web Content Accessibility Guidelines (WCAG) for the underlying accessibility reference.

License

GPL-3.0 © 2026 Interested-Deving-1896