# orionshinesbright/debian-sway architecture

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

- Interactive diagram: https://gitdiagram.com/orionshinesbright/debian-sway
- Repository: https://github.com/orionshinesbright/debian-sway

## Overview

This repository is a Debian/Sway workstation setup bundle: the documented workflow is to clone it and run `post-install` on an installed Debian system. Its files include shell, Sway, Neovim, Foot, and btop configuration, plus a Sway systemd user drop-in. The README does not describe how the installer applies these files or how `setup-customizations` participates, and no source excerpts were provided, so those relationships are left unspecified.

Main entry points: [`post-install`](https://github.com/orionshinesbright/debian-sway/blob/main/post-install) (Post-install)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_installation["Installation"]
  node_post_install["Post-install"]
  node_customizations["Customizations setup"]
end

subgraph group_user_config["User configuration"]
  node_shell_profiles["Shell profiles<br/>[.bashrc]"]
  node_user_profile["User profile<br/>[.profile]"]
  node_sway_config["Sway configuration<br/>[config]"]
  node_nvim_config["Neovim configuration<br/>[init.lua]"]
  node_foot_config["Foot configuration<br/>[foot.ini]"]
  node_btop_config["btop configuration<br/>[btop.conf]"]
end

subgraph group_system_config["System configuration"]
  node_sway_systemd_dropin["Sway systemd drop-in"]
end

node_operator(("System operator"))

node_operator -->|"runs"| node_post_install

click node_post_install "https://github.com/orionshinesbright/debian-sway/blob/main/post-install"
click node_customizations "https://github.com/orionshinesbright/debian-sway/blob/main/setup-customizations"
click node_shell_profiles "https://github.com/orionshinesbright/debian-sway/blob/main/files/.bashrc"
click node_user_profile "https://github.com/orionshinesbright/debian-sway/blob/main/files/.profile"
click node_sway_config "https://github.com/orionshinesbright/debian-sway/blob/main/files/.config/sway/config"
click node_nvim_config "https://github.com/orionshinesbright/debian-sway/blob/main/files/.config/nvim/init.lua"
click node_foot_config "https://github.com/orionshinesbright/debian-sway/blob/main/files/.config/foot/foot.ini"
click node_btop_config "https://github.com/orionshinesbright/debian-sway/blob/main/files/.config/btop/btop.conf"
click node_sway_systemd_dropin "https://github.com/orionshinesbright/debian-sway/blob/main/files/.config/sway/config.d/50-systemd-user.conf"

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_post_install,node_customizations toneBlue
class node_shell_profiles,node_user_profile,node_sway_config,node_nvim_config,node_foot_config,node_btop_config toneAmber
class node_sway_systemd_dropin toneMint
class node_operator toneIndigo
```

## Components

### Installation

- [Post-install](https://github.com/orionshinesbright/debian-sway/blob/main/post-install): `post-install`
- [Customizations setup](https://github.com/orionshinesbright/debian-sway/blob/main/setup-customizations): `setup-customizations`

### User configuration

- [Shell profiles](https://github.com/orionshinesbright/debian-sway/blob/main/files/.bashrc): `files/.bashrc`
- [User profile](https://github.com/orionshinesbright/debian-sway/blob/main/files/.profile): `files/.profile`
- [Sway configuration](https://github.com/orionshinesbright/debian-sway/blob/main/files/.config/sway/config): `files/.config/sway/config`
- [Neovim configuration](https://github.com/orionshinesbright/debian-sway/blob/main/files/.config/nvim/init.lua): `files/.config/nvim/init.lua`
- [Foot configuration](https://github.com/orionshinesbright/debian-sway/blob/main/files/.config/foot/foot.ini): `files/.config/foot/foot.ini`
- [btop configuration](https://github.com/orionshinesbright/debian-sway/blob/main/files/.config/btop/btop.conf): `files/.config/btop/btop.conf`

### System configuration

- [Sway systemd drop-in](https://github.com/orionshinesbright/debian-sway/blob/main/files/.config/sway/config.d/50-systemd-user.conf): `files/.config/sway/config.d/50-systemd-user.conf`

### Other components

- **System operator**

## Connections

- System operator → Post-install: runs (evidence: `README.md`)