# cachyos/cachyos-pkgbuilds architecture

> Architecture diagram of the GitHub repository cachyos/cachyos-pkgbuilds, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cachyos/cachyos-pkgbuilds
- Repository: https://github.com/cachyos/cachyos-pkgbuilds

## Overview

CachyOS PKGBUILDS is a repository of Arch Linux package recipes, not a single application. A user chooses a package directory, builds it with makepkg, and installs the resulting archive with pacman. The tree shows broad package families spanning system foundations, desktop configuration, gaming and handheld support, and developer tools. The README documents the build-and-install steps; the sampled source files are package contents and do not establish further runtime wiring.

Main entry points: [`arch-install-scripts`](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/arch-install-scripts) (Base system), [`nvidia`](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/nvidia) (Kernel and drivers), [`dracut-cachyos`](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/dracut-cachyos) (Boot and initramfs), [`cachy-update`](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/cachy-update) (System utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Package workflow"]
  node_makepkg["makepkg"]
  node_archive["Package archive"]
  node_pacman["pacman"]
  node_installed["Arch-based system"]
end

subgraph group_system["System packages"]
  node_base["Base system"]
  node_kernel["Kernel and drivers"]
  node_boot["Boot and initramfs"]
  node_system_tools["System utilities"]
end

subgraph group_desktop["Desktop packages"]
  node_desktop_settings["Desktop settings"]
  node_desktop_shells["Desktop shells"]
  node_desktop_apps["Desktop applications"]
end

subgraph group_gaming["Gaming packages"]
  node_gaming_apps["Gaming applications"]
  node_gaming_runtime["Gaming runtime"]
  node_handheld["Handheld support"]
end

subgraph group_development["Development packages"]
  node_compiler_stack["Compiler stack"]
  node_language_runtimes["Language runtimes"]
  node_developer_tools["Developer tools"]
end

node_user(("Package user"))

node_user -->|"invokes build"| node_makepkg
node_makepkg -->|"reads recipes"| node_base
node_makepkg -->|"reads recipes"| node_kernel
node_makepkg -->|"reads recipes"| node_boot
node_makepkg -->|"reads recipes"| node_system_tools
node_makepkg -->|"reads recipes"| node_desktop_settings
node_makepkg -->|"reads recipes"| node_desktop_shells
node_makepkg -->|"reads recipes"| node_desktop_apps
node_makepkg -->|"reads recipes"| node_gaming_apps
node_makepkg -->|"reads recipes"| node_gaming_runtime
node_makepkg -->|"reads recipes"| node_handheld
node_makepkg -->|"reads recipes"| node_compiler_stack
node_makepkg -->|"reads recipes"| node_language_runtimes
node_makepkg -->|"reads recipes"| node_developer_tools
node_makepkg -->|"produces archive"| node_archive
node_user -->|"requests install"| node_pacman
node_pacman -->|"installs archive"| node_archive
node_pacman -->|"updates system"| node_installed

click node_base "https://github.com/cachyos/cachyos-pkgbuilds/tree/master/arch-install-scripts"
click node_kernel "https://github.com/cachyos/cachyos-pkgbuilds/tree/master/nvidia"
click node_boot "https://github.com/cachyos/cachyos-pkgbuilds/tree/master/dracut-cachyos"
click node_system_tools "https://github.com/cachyos/cachyos-pkgbuilds/tree/master/cachy-update"
click node_desktop_settings "https://github.com/cachyos/cachyos-pkgbuilds/tree/master/cachyos-gnome-settings"
click node_desktop_shells "https://github.com/cachyos/cachyos-pkgbuilds/tree/master/dms-shell"
click node_desktop_apps "https://github.com/cachyos/cachyos-pkgbuilds/tree/master/cachyos-packageinstaller"
click node_gaming_apps "https://github.com/cachyos/cachyos-pkgbuilds/tree/master/cachyos-gaming-applications"
click node_gaming_runtime "https://github.com/cachyos/cachyos-pkgbuilds/tree/master/proton-cachyos-native"
click node_handheld "https://github.com/cachyos/cachyos-pkgbuilds/tree/master/handheld"
click node_compiler_stack "https://github.com/cachyos/cachyos-pkgbuilds/tree/master/toolchain"
click node_language_runtimes "https://github.com/cachyos/cachyos-pkgbuilds/tree/master/python"
click node_developer_tools "https://github.com/cachyos/cachyos-pkgbuilds/tree/master/devtools"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_makepkg,node_archive,node_pacman,node_installed,node_user toneBlue
class node_base,node_kernel,node_boot,node_system_tools toneAmber
class node_desktop_settings,node_desktop_shells,node_desktop_apps toneMint
class node_gaming_apps,node_gaming_runtime,node_handheld toneRose
class node_compiler_stack,node_language_runtimes,node_developer_tools toneIndigo
```

## Components

### Package workflow

- **makepkg**
- **Package archive**
- **pacman**
- **Arch-based system**

### System packages

- [Base system](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/arch-install-scripts): `arch-install-scripts`
- [Kernel and drivers](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/nvidia): `nvidia`
- [Boot and initramfs](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/dracut-cachyos): `dracut-cachyos`
- [System utilities](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/cachy-update): `cachy-update`

### Desktop packages

- [Desktop settings](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/cachyos-gnome-settings): `cachyos-gnome-settings`
- [Desktop shells](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/dms-shell): `dms-shell`
- [Desktop applications](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/cachyos-packageinstaller): `cachyos-packageinstaller`

### Gaming packages

- [Gaming applications](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/cachyos-gaming-applications): `cachyos-gaming-applications`
- [Gaming runtime](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/proton-cachyos-native): `proton-cachyos-native`
- [Handheld support](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/handheld): `handheld`

### Development packages

- [Compiler stack](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/toolchain): `toolchain`
- [Language runtimes](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/python): `python`
- [Developer tools](https://github.com/cachyos/cachyos-pkgbuilds/tree/master/devtools): `devtools`

### Other components

- **Package user**

## Connections

- Package user → makepkg: invokes build
- makepkg → Base system: reads recipes
- makepkg → Kernel and drivers: reads recipes
- makepkg → Boot and initramfs: reads recipes
- makepkg → System utilities: reads recipes
- makepkg → Desktop settings: reads recipes
- makepkg → Desktop shells: reads recipes
- makepkg → Desktop applications: reads recipes
- makepkg → Gaming applications: reads recipes
- makepkg → Gaming runtime: reads recipes
- makepkg → Handheld support: reads recipes
- makepkg → Compiler stack: reads recipes
- makepkg → Language runtimes: reads recipes
- makepkg → Developer tools: reads recipes
- makepkg → Package archive: produces archive
- Package user → pacman: requests install
- pacman → Package archive: installs archive
- pacman → Arch-based system: updates system