# yvnth/dotfiles architecture

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

- Interactive diagram: https://gitdiagram.com/yvnth/dotfiles
- Repository: https://github.com/yvnth/dotfiles

## Overview

This repository is a personal NixOS configuration managed with flakes and home-manager. Its user-facing workflow is to configure a machine through its host-specific settings, which cover system and home configuration, while reusable core modules, home modules, custom packages, and encrypted secrets provide capabilities. The README documents these major areas and names Mango, Lanzaboote, and sops-nix; no source excerpts were supplied, so internal wiring is left unverified.

Main entry points: [`hosts/satella/configuration.nix`](https://github.com/yvnth/dotfiles/blob/master/hosts/satella/configuration.nix) (Satella host), [`modules/core`](https://github.com/yvnth/dotfiles/tree/master/modules/core) (System modules), [`modules/home`](https://github.com/yvnth/dotfiles/tree/master/modules/home) (Home modules), [`hosts/satella/packages.nix`](https://github.com/yvnth/dotfiles/blob/master/hosts/satella/packages.nix) (Host packages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_host["Host configuration"]
  node_machine["Satella host<br/>[configuration.nix]"]
  node_hardware["Hardware setup"]
  node_disk["Disk layout<br/>[disko.nix]"]
  node_hosthome["Host home config<br/>[home.nix]"]
  node_hostpackages["Host packages<br/>[packages.nix]"]
end

subgraph group_system["System modules"]
  node_core["System modules"]
  node_secureboot["Secure Boot<br/>[lanzaboote.nix]"]
  node_systemsecrets["System secrets<br/>[sops.nix]"]
end

subgraph group_home["Home environment"]
  node_home["Home modules"]
  node_mango["Mango desktop<br/>[default.nix]"]
  node_homeapps["Home applications<br/>[default.nix]"]
end

subgraph group_extensions["Packages and secrets"]
  node_custompkg["Rofi pass<br/>[default.nix]"]
  node_secrets["Encrypted secrets"]
end

node_user(("User"))

node_user -.->|"configures"| node_machine
node_machine -.->|"uses settings"| node_hardware
node_machine -.->|"uses layout"| node_disk
node_machine -.->|"sets up home"| node_hosthome
node_machine -.->|"selects packages"| node_hostpackages
node_machine -.->|"uses modules"| node_core
node_machine -.->|"uses modules"| node_home
node_core -.->|"includes capability"| node_secureboot
node_core -.->|"includes capability"| node_systemsecrets
node_home -.->|"includes desktop"| node_mango
node_home -.->|"includes applications"| node_homeapps
node_hostpackages -.->|"may select"| node_custompkg
node_systemsecrets -.->|"may consume"| node_secrets

click node_machine "https://github.com/yvnth/dotfiles/blob/master/hosts/satella/configuration.nix"
click node_hardware "https://github.com/yvnth/dotfiles/blob/master/hosts/satella/hardware-configuration.nix"
click node_disk "https://github.com/yvnth/dotfiles/blob/master/hosts/satella/disko.nix"
click node_hosthome "https://github.com/yvnth/dotfiles/blob/master/hosts/satella/home.nix"
click node_hostpackages "https://github.com/yvnth/dotfiles/blob/master/hosts/satella/packages.nix"
click node_core "https://github.com/yvnth/dotfiles/tree/master/modules/core"
click node_secureboot "https://github.com/yvnth/dotfiles/blob/master/modules/core/lanzaboote.nix"
click node_systemsecrets "https://github.com/yvnth/dotfiles/blob/master/modules/core/sops.nix"
click node_home "https://github.com/yvnth/dotfiles/tree/master/modules/home"
click node_mango "https://github.com/yvnth/dotfiles/blob/master/modules/home/mango/default.nix"
click node_homeapps "https://github.com/yvnth/dotfiles/blob/master/modules/home/rofi/default.nix"
click node_custompkg "https://github.com/yvnth/dotfiles/blob/master/pkgs/rofi-pass/default.nix"
click node_secrets "https://github.com/yvnth/dotfiles/tree/master/secrets"

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_machine,node_hardware,node_disk,node_hosthome,node_hostpackages,node_user toneBlue
class node_core,node_secureboot,node_systemsecrets toneAmber
class node_home,node_mango,node_homeapps toneMint
class node_custompkg,node_secrets toneRose
```

## Components

### Host configuration

- [Satella host](https://github.com/yvnth/dotfiles/blob/master/hosts/satella/configuration.nix): `hosts/satella/configuration.nix`
- [Hardware setup](https://github.com/yvnth/dotfiles/blob/master/hosts/satella/hardware-configuration.nix): `hosts/satella/hardware-configuration.nix`
- [Disk layout](https://github.com/yvnth/dotfiles/blob/master/hosts/satella/disko.nix): `hosts/satella/disko.nix`
- [Host home config](https://github.com/yvnth/dotfiles/blob/master/hosts/satella/home.nix): `hosts/satella/home.nix`
- [Host packages](https://github.com/yvnth/dotfiles/blob/master/hosts/satella/packages.nix): `hosts/satella/packages.nix`

### System modules

- [System modules](https://github.com/yvnth/dotfiles/tree/master/modules/core): `modules/core`
- [Secure Boot](https://github.com/yvnth/dotfiles/blob/master/modules/core/lanzaboote.nix): `modules/core/lanzaboote.nix`
- [System secrets](https://github.com/yvnth/dotfiles/blob/master/modules/core/sops.nix): `modules/core/sops.nix`

### Home environment

- [Home modules](https://github.com/yvnth/dotfiles/tree/master/modules/home): `modules/home`
- [Mango desktop](https://github.com/yvnth/dotfiles/blob/master/modules/home/mango/default.nix): `modules/home/mango/default.nix`
- [Home applications](https://github.com/yvnth/dotfiles/blob/master/modules/home/rofi/default.nix): `modules/home/rofi/default.nix`

### Packages and secrets

- [Rofi pass](https://github.com/yvnth/dotfiles/blob/master/pkgs/rofi-pass/default.nix): `pkgs/rofi-pass/default.nix`
- [Encrypted secrets](https://github.com/yvnth/dotfiles/tree/master/secrets): `secrets`

### Other components

- **User**

## Connections

- User → Satella host: configures
- Satella host → Hardware setup: uses settings
- Satella host → Disk layout: uses layout
- Satella host → Host home config: sets up home
- Satella host → Host packages: selects packages
- Satella host → System modules: uses modules
- Satella host → Home modules: uses modules
- System modules → Secure Boot: includes capability
- System modules → System secrets: includes capability
- Home modules → Mango desktop: includes desktop
- Home modules → Home applications: includes applications
- Host packages → Rofi pass: may select
- System secrets → Encrypted secrets: may consume
