# nazwasadfh/main-blitz architecture

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

- Interactive diagram: https://gitdiagram.com/nazwasadfh/main-blitz
- Repository: https://github.com/nazwasadfh/main-blitz

## Overview

BlitzArt is an Artix Linux distribution whose documented user-facing flow is booting a live ISO to a tty, then using `blitzinstall` to install the system. Its documented product capabilities include a btrfs layout, Snapper snapshots and pacman hooks, grub-btrfs integration, and BlitzArt identity and live-session defaults. The tree identifies the relevant implementation files, but no source excerpts were provided; edges below are limited to relationships stated in the README.

Main entry points: [`src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-snap`](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-snap) (Snapper root config), [`src/profile/blitzart/live-overlay/usr/share/blitzart/00-blitzart-snap-pre.hook`](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/00-blitzart-snap-pre.hook) (Pre-transaction hook), [`src/profile/blitzart/live-overlay/usr/share/blitzart/zz-blitzart-snap-post.hook`](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/zz-blitzart-snap-post.hook) (Post-transaction hook), [`src/profile/blitzart/live-overlay/usr/share/blitzart/grub-btrfsd.dinit`](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/grub-btrfsd.dinit) (Dinit service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_live["Live environment"]
  node_tty["TTY login"]
  node_live_defaults["Live defaults<br/>[.bash_profile]"]
end

subgraph group_install["Installation"]
  node_installer["Blitz installer"]
  node_install_profile["Install profile<br/>[profile.yaml]"]
  node_filesystem["Btrfs layout<br/>[profile.yaml]"]
end

subgraph group_recovery["Snapshots and recovery"]
  node_snap_hooks["Snap hooks"]
  node_pre_hook["Pre-transaction hook"]
  node_post_hook["Post-transaction hook"]
  node_snapper[("Snapper root config")]
  node_grub_btrfs["Grub snapshot boot"]
  node_dinit_service["Dinit service<br/>[grub-btrfsd.dinit]"]
end

subgraph group_identity["System identity"]
  node_os_release["OS release identity"]
  node_motd["Login message"]
end

node_user(("Live user"))
node_blitz["Blitz toolbox"]
node_pacman["Pacman transactions"]

node_user -->|"logs in"| node_tty
node_user -->|"runs"| node_installer
node_pacman -->|"runs before"| node_pre_hook
node_pacman -->|"runs after"| node_post_hook
node_pre_hook -->|"creates pre-snapshot"| node_snapper
node_post_hook -->|"creates post-snapshot"| node_snapper
node_blitz -->|"makes update pair"| node_snapper
node_snapper -->|"snapshots root"| node_filesystem
node_dinit_service -->|"runs service"| node_grub_btrfs

click node_tty "https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/etc/issue"
click node_live_defaults "https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/etc/skel/.bash_profile"
click node_installer "https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/local/bin/blitzinstall"
click node_install_profile "https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/profile.yaml"
click node_filesystem "https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/profile.yaml"
click node_snap_hooks "https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-snap"
click node_pre_hook "https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/00-blitzart-snap-pre.hook"
click node_post_hook "https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/zz-blitzart-snap-post.hook"
click node_snapper "https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-snap"
click node_grub_btrfs "https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-grub-btrfsd"
click node_dinit_service "https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/grub-btrfsd.dinit"
click node_os_release "https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-os-release.hook"
click node_motd "https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/etc/motd"

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_tty,node_live_defaults,node_user toneBlue
class node_installer,node_install_profile,node_filesystem toneAmber
class node_snap_hooks,node_pre_hook,node_post_hook,node_snapper,node_grub_btrfs,node_dinit_service toneMint
class node_os_release,node_motd toneRose
class node_blitz,node_pacman toneIndigo
```

## Components

### Live environment

- [TTY login](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/etc/issue): `src/profile/blitzart/live-overlay/etc/issue`
- [Live defaults](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/etc/skel/.bash_profile): `src/profile/blitzart/live-overlay/etc/skel/.bash_profile`

### Installation

- [Blitz installer](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/local/bin/blitzinstall): `src/profile/blitzart/live-overlay/usr/local/bin/blitzinstall`
- [Install profile](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/profile.yaml): `src/profile/blitzart/profile.yaml`
- [Btrfs layout](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/profile.yaml): `src/profile/blitzart/profile.yaml`

### Snapshots and recovery

- [Snap hooks](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-snap): `src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-snap`
- [Pre-transaction hook](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/00-blitzart-snap-pre.hook): `src/profile/blitzart/live-overlay/usr/share/blitzart/00-blitzart-snap-pre.hook`
- [Post-transaction hook](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/zz-blitzart-snap-post.hook): `src/profile/blitzart/live-overlay/usr/share/blitzart/zz-blitzart-snap-post.hook`
- [Snapper root config](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-snap): `src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-snap`
- [Grub snapshot boot](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-grub-btrfsd): `src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-grub-btrfsd`
- [Dinit service](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/grub-btrfsd.dinit): `src/profile/blitzart/live-overlay/usr/share/blitzart/grub-btrfsd.dinit`

### System identity

- [OS release identity](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-os-release.hook): `src/profile/blitzart/live-overlay/usr/share/blitzart/blitzart-os-release.hook`
- [Login message](https://github.com/nazwasadfh/main-blitz/blob/master/src/profile/blitzart/live-overlay/etc/motd): `src/profile/blitzart/live-overlay/etc/motd`

### Other components

- **Live user**
- **Blitz toolbox**
- **Pacman transactions**

## Connections

- Live user → TTY login: logs in (evidence: `README.md`)
- Live user → Blitz installer: runs (evidence: `README.md`)
- Pacman transactions → Pre-transaction hook: runs before (evidence: `README.md`)
- Pacman transactions → Post-transaction hook: runs after (evidence: `README.md`)
- Pre-transaction hook → Snapper root config: creates pre-snapshot (evidence: `README.md`)
- Post-transaction hook → Snapper root config: creates post-snapshot (evidence: `README.md`)
- Blitz toolbox → Snapper root config: makes update pair (evidence: `README.md`)
- Snapper root config → Btrfs layout: snapshots root (evidence: `README.md`)
- Dinit service → Grub snapshot boot: runs service (evidence: `README.md`)
