# souandresouza/ruwall architecture

> Architecture diagram of the GitHub repository souandresouza/ruwall, 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/souandresouza/ruwall
- Repository: https://github.com/souandresouza/ruwall

## Overview

Ruwall is a Rust CLI that generates a color scheme from an image or loads a predefined theme, then exports files and applies colors to terminals and the desktop environment. The main workflow branches at theme selection: image input is resolved and analyzed into a palette, while a selected theme is loaded directly. Both paths lead to export and optional runtime application. README and source-index references establish the main relationships; unsampled CLI internals are not asserted beyond the documented workflow.

Main entry points: [`src/main.rs`](https://github.com/souandresouza/ruwall/blob/main/src/main.rs) (CLI orchestration), [`src/theme.rs`](https://github.com/souandresouza/ruwall/blob/main/src/theme.rs) (Theme loading), [`src/colors.rs`](https://github.com/souandresouza/ruwall/blob/main/src/colors.rs) (Palette generation), [`src/export.rs`](https://github.com/souandresouza/ruwall/blob/main/src/export.rs) (Template export)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI workflow"]
  node_main["CLI orchestration<br/>[main.rs]"]
  node_image["Image selection<br/>[image.rs]"]
end

subgraph group_themes["Theme generation"]
  node_theme["Theme loading<br/>[theme.rs]"]
  node_colors["Palette generation<br/>[colors.rs]"]
  node_backend["Color backends<br/>[backend.rs]"]
  node_settings["Paths and assets<br/>[settings.rs]"]
  node_util["File and color utilities<br/>[util.rs]"]
end

subgraph group_output["Output and cache"]
  node_assets["Themes and templates"]
  node_export["Template export<br/>[export.rs]"]
  node_cache["Generated cache<br/>[settings.rs]"]
end

subgraph group_apply["System application"]
  node_sequences["Terminal sequences<br/>[sequences.rs]"]
  node_wallpaper["Wallpaper control<br/>[wallpaper.rs]"]
  node_reload["Environment reload<br/>[reload.rs]"]
end

node_user(("CLI user"))
node_system["Terminals and desktop"]

node_user -->|"invokes"| node_main
node_main -->|"selects image"| node_image
node_main -->|"selects theme"| node_theme
node_image -->|"reads current"| node_wallpaper
node_main -->|"generates palette"| node_colors
node_colors -->|"dispatches to"| node_backend
node_colors -->|"builds theme"| node_theme
node_main -->|"exports files"| node_export
node_main -->|"applies colors"| node_sequences
node_main -->|"sets wallpaper"| node_wallpaper
node_main -->|"reloads programs"| node_reload
node_export -->|"renders from"| node_theme
node_theme -->|"loads built-ins"| node_assets
node_export -->|"reads templates"| node_assets
node_settings -->|"embeds assets"| node_assets
node_colors -->|"reads and writes"| node_cache
node_export -->|"writes outputs"| node_cache
node_sequences -->|"saves sequences"| node_cache
node_sequences -->|"writes terminals"| node_system
node_wallpaper -->|"sets wallpaper"| node_system
node_reload -->|"reloads programs"| node_system
node_theme -->|"uses paths"| node_settings
node_colors -->|"uses cache path"| node_settings
node_export -->|"uses asset paths"| node_settings
node_sequences -->|"reads colors"| node_theme
node_wallpaper -->|"uses system paths"| node_settings
node_reload -->|"uses cache and assets"| node_settings
node_colors -->|"uses color helpers"| node_util
node_export -->|"uses file helpers"| node_util
node_theme -->|"uses file helpers"| node_util
node_sequences -->|"writes files"| node_util
node_wallpaper -->|"runs commands"| node_util
node_reload -->|"runs reload commands"| node_util

click node_main "https://github.com/souandresouza/ruwall/blob/main/src/main.rs"
click node_image "https://github.com/souandresouza/ruwall/blob/main/src/image.rs"
click node_theme "https://github.com/souandresouza/ruwall/blob/main/src/theme.rs"
click node_colors "https://github.com/souandresouza/ruwall/blob/main/src/colors.rs"
click node_backend "https://github.com/souandresouza/ruwall/blob/main/src/backend.rs"
click node_settings "https://github.com/souandresouza/ruwall/blob/main/src/settings.rs"
click node_util "https://github.com/souandresouza/ruwall/blob/main/src/util.rs"
click node_assets "https://github.com/souandresouza/ruwall/tree/main/assets"
click node_export "https://github.com/souandresouza/ruwall/blob/main/src/export.rs"
click node_cache "https://github.com/souandresouza/ruwall/blob/main/src/settings.rs"
click node_sequences "https://github.com/souandresouza/ruwall/blob/main/src/sequences.rs"
click node_wallpaper "https://github.com/souandresouza/ruwall/blob/main/src/wallpaper.rs"
click node_reload "https://github.com/souandresouza/ruwall/blob/main/src/reload.rs"

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_main,node_image,node_user toneBlue
class node_theme,node_colors,node_backend,node_settings,node_util toneAmber
class node_assets,node_export,node_cache toneMint
class node_sequences,node_wallpaper,node_reload toneRose
class node_system toneIndigo
```

## Components

### CLI workflow

- [CLI orchestration](https://github.com/souandresouza/ruwall/blob/main/src/main.rs): `src/main.rs`
- [Image selection](https://github.com/souandresouza/ruwall/blob/main/src/image.rs): `src/image.rs`

### Theme generation

- [Theme loading](https://github.com/souandresouza/ruwall/blob/main/src/theme.rs): `src/theme.rs`
- [Palette generation](https://github.com/souandresouza/ruwall/blob/main/src/colors.rs): `src/colors.rs`
- [Color backends](https://github.com/souandresouza/ruwall/blob/main/src/backend.rs): `src/backend.rs`
- [Paths and assets](https://github.com/souandresouza/ruwall/blob/main/src/settings.rs): `src/settings.rs`
- [File and color utilities](https://github.com/souandresouza/ruwall/blob/main/src/util.rs): `src/util.rs`

### Output and cache

- [Themes and templates](https://github.com/souandresouza/ruwall/tree/main/assets): `assets`
- [Template export](https://github.com/souandresouza/ruwall/blob/main/src/export.rs): `src/export.rs`
- [Generated cache](https://github.com/souandresouza/ruwall/blob/main/src/settings.rs): `src/settings.rs`

### System application

- [Terminal sequences](https://github.com/souandresouza/ruwall/blob/main/src/sequences.rs): `src/sequences.rs`
- [Wallpaper control](https://github.com/souandresouza/ruwall/blob/main/src/wallpaper.rs): `src/wallpaper.rs`
- [Environment reload](https://github.com/souandresouza/ruwall/blob/main/src/reload.rs): `src/reload.rs`

### Other components

- **CLI user**
- **Terminals and desktop**

## Connections

- CLI user → CLI orchestration: invokes (evidence: `README.md`)
- CLI orchestration → Image selection: selects image (evidence: `README.md`)
- CLI orchestration → Theme loading: selects theme (evidence: `README.md`)
- Image selection → Wallpaper control: reads current (evidence: `src/image.rs`)
- CLI orchestration → Palette generation: generates palette (evidence: `README.md`)
- Palette generation → Color backends: dispatches to (evidence: `src/colors.rs`)
- Palette generation → Theme loading: builds theme (evidence: `src/colors.rs`)
- CLI orchestration → Template export: exports files (evidence: `README.md`)
- CLI orchestration → Terminal sequences: applies colors (evidence: `README.md`)
- CLI orchestration → Wallpaper control: sets wallpaper (evidence: `README.md`)
- CLI orchestration → Environment reload: reloads programs (evidence: `README.md`)
- Template export → Theme loading: renders from (evidence: `src/export.rs`)
- Theme loading → Themes and templates: loads built-ins (evidence: `README.md`)
- Template export → Themes and templates: reads templates (evidence: `README.md`)
- Paths and assets → Themes and templates: embeds assets (evidence: `src/settings.rs`)
- Palette generation → Generated cache: reads and writes (evidence: `src/colors.rs`)
- Template export → Generated cache: writes outputs (evidence: `README.md`)
- Terminal sequences → Generated cache: saves sequences (evidence: `src/sequences.rs`)
- Terminal sequences → Terminals and desktop: writes terminals (evidence: `README.md`)
- Wallpaper control → Terminals and desktop: sets wallpaper (evidence: `src/wallpaper.rs`)
- Environment reload → Terminals and desktop: reloads programs (evidence: `src/reload.rs`)
- Theme loading → Paths and assets: uses paths (evidence: `src/theme.rs`)
- Palette generation → Paths and assets: uses cache path (evidence: `src/colors.rs`)
- Template export → Paths and assets: uses asset paths (evidence: `src/export.rs`)
- Terminal sequences → Theme loading: reads colors (evidence: `src/sequences.rs`)
- Wallpaper control → Paths and assets: uses system paths (evidence: `src/wallpaper.rs`)
- Environment reload → Paths and assets: uses cache and assets (evidence: `src/reload.rs`)
- Palette generation → File and color utilities: uses color helpers (evidence: `src/colors.rs`)
- Template export → File and color utilities: uses file helpers (evidence: `src/export.rs`)
- Theme loading → File and color utilities: uses file helpers (evidence: `src/theme.rs`)
- Terminal sequences → File and color utilities: writes files (evidence: `src/sequences.rs`)
- Wallpaper control → File and color utilities: runs commands (evidence: `src/wallpaper.rs`)
- Environment reload → File and color utilities: runs reload commands (evidence: `src/reload.rs`)
