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

KPort

KPort provides a Portage-inspired package repository for KDE Neon, integrating Pacstall with support for USE flags and hardware compatibility layers for CPU, GPU, and NPU. It automates pacscript generation from KDE Neon packaging, enabling developers and advanced users to customize and optimize software builds for specific hardware configurations.

Architecture

KPort consists of modular components for managing KDE Neon packages with Pacstall, leveraging USE flags and hardware compatibility layers. The repository automates pacscript generation and integrates workflows for CI/CD, hardware detection, and repository synchronization. Key components include:

• bin/: Executables for package management and script utilities.
• config/: Configuration files for repository and build settings.
• db/: Metadata and dependency information for packages.
• generated/: Auto-generated pacscripts and related files.
• lib/: Shared libraries and helper scripts.
• overlays/: Custom package overlays for specific configurations.
• packages/: Source definitions for KDE Neon packages.
• scripts/: Automation scripts for tasks like hardware detection and CI.
• vendor/: External dependencies and third-party tools.

Workflows in .github/workflows/ handle tasks such as syncing with GitLab, detecting hardware, building packages, and maintaining pacscripts.

Directory structure:

.
├── .github/
│   └── workflows/
├── bin/
├── config/
├── db/
├── dep-graph/
├── generated/
├── lib/
├── overlays/
├── packages/
├── scripts/
└── vendor/

Install

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

Usage

Configuration

CI

• check-gitlab-sync.yml: Verifies synchronization between this repository and a GitLab mirror. No secrets required.
• hardware-detect.yml: Detects CPU, GPU, and NPU hardware compatibility layers. Requires HW_DETECT_API_KEY secret.
• neon-build-ci.yml: Builds and tests KDE Neon packages for compatibility. Requires NEON_CI_TOKEN secret.
• notify-hw-detect-consumers.yml: Notifies downstream consumers of hardware detection updates. Requires WEBHOOK_URL secret.
• pacscript-ci.yml: Validates and generates pacscripts from KDE Neon packaging. No secrets required.
• rebase-prs.yml: Automatically rebases open pull requests on the latest main branch. No secrets required.
• update-kde-builder-vendor.yml: Updates vendor dependencies for KDE Neon package building. No secrets required.

Mirror chain

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

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

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

@Interested-Deving-1896: 366 commits

Note: This repository is a mirror. Please refer to the upstream source for the original project.

Origins

KPort is an original project — a Portage-inspired package repository for KDE Neon using Pacstall. It was created from the following upstream inspirations:

Origin	Host	Fork in I-D-1896
KDE/neon-neon-repositories	GitHub	✅
neon/ubuntu-core	KDE Invent	✅
neon/pkg-kde-tools	KDE Invent	✅
neon/pkg-kde-jenkins	KDE Invent	✅
neon/pkg-kde-dev-scripts	KDE Invent	✅
neon/docker-images	KDE Invent	✅
neon/qt-kde-team.pages.debian.net	KDE Invent	✅
gentoo/portage	GitHub	✅
pacstall/pacstall	GitHub	✅
KDE/craft	GitHub	✅
KDE/craft-blueprints-kde	GitHub	✅
KDE/craft-blueprints-community	GitHub	✅
KDE/kde-builder	GitHub	✅
KDE/kdesrc-build	GitHub	✅
KDE/kde-build-metadata	GitHub	✅
KDE/kdevplatform	GitHub	✅
KDE/superbuild	GitHub	✅
KDE/android-builder	GitHub	✅

Resources

File	Description
dep-graph/origins.md	Dependency graph (Markdown table)

License

MIT © 2026 Interested-Deving-1896