# geodearc/geodots architecture

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

- Interactive diagram: https://gitdiagram.com/geodearc/geodots
- Repository: https://github.com/geodearc/geodots

## Overview

##### Project type and purpose
- GeoDots is an open-source configuration-management and installer tool for Arch-based Linux distributions. It provides a central repository of dot-file templates, scripts, and an automated installer (`install.sh`) to deploy a consistent desktop environment (Hyprland, Waybar, Rofi, SDDM, etc.) with theming support.

##### File structure
- Top-level:
- `.config/` – a tree of per-application config templates (hypr, rofi, swaync, waybar, etc.)
- `Dots/` – symlink targets, options, guides, and scripts for post-install configuration
- `Installation/` – scripts to orchestrate package installation and troubleshooting
- `install.sh` – launcher that pulls down the repo and invokes `Installation/main-guidedinstall.sh`
- `README.md` – user documentation and feature overview
- Patterns:
- Modular config templates under `.config/<app>/<style>/<theme>`
- A central `Dots/Scripts` library to apply settings and themes
- Installer separation: bootstrap => package install => config deploy => post-install tweaks

##### README for additional insights
- Confirms support for Arch-based distros, dependency on `pacman`, `git`, `curl`, `bash`
- Describes manual and automated install flows
- Highlights theming features, future roadmap (extensibility)

##### Final advice
- Be exhaustive in mapping every script folder and config template as a sub-component
- User-choice logic (style/theme selection) as a decision node
- Do not over-abstract—show each layer from “fetch” to “deploy” to “finalize” to give full visibility into how GeoDots orchestrates the user’s desktop setup.

## Diagram (Mermaid)

```mermaid
graph TD
  User["User"]:::external
  Repo["GitHub Repo"]:::external

  subgraph "Installer"
    IS["install.sh"]:::local
    MG["main-guidedinstall.sh"]:::local
    IO["install-options.sh"]:::local
    IP["install-packages.sh"]:::local
    TR["troubleshooter.sh"]:::local
  end

  PM["Pacman"]:::system
  OS["Arch-based OS"]:::system

  subgraph "Template Store"
    CT[".config/"]:::local
  end

  subgraph "Dots Library"
    DC["Dots/Config/"]:::local
    DG["Dots/Guide/"]:::local
    DO["Dots/Options/"]:::local
  end

  DE["settings.sh"]:::local

  subgraph "Post-Install Scripts"
    PI["postinstall.sh"]:::local
    PU["postupgrade.sh"]:::local
    subgraph "Hyprland Scripts"
      HY1["mediaexec.sh"]:::local
      HY2["mediatoggle.sh"]:::local
      HY3["startup.sh"]:::local
      HY4["wall.sh"]:::local
    end
    subgraph "Waybar Scripts"
      WB1["waybar.sh"]:::local
      WB2["waybaropt.sh"]:::local
      WB3["waybartoggle.sh"]:::local
    end
    subgraph "Theme Scripts"
      TH1["s-col.sh"]:::local
      TH2["s-min.sh"]:::local
      TH3["s-mod.sh"]:::local
      TH4["t-dark.sh"]:::local
      TH5["t-light.sh"]:::local
    end
  end

  WP["Dots/Wallpapers/"]:::local
  RD["README.md"]:::local

  Decision{"Select style/theme/options"}:::decision

  %% Connections
  User -->|invokes| IS
  IS -->|fetch repo| Repo
  IS -->|start installer| MG
  MG -->|load options| IO
  MG -->|install packages| IP
  IP -->|uses| PM
  IP --> OS
  MG -->|run troubleshooter| TR
  MG --> Decision
  Decision --> CT
  Decision --> DO
  Decision --> WP
  Decision --> DG
  CT --> DE
  DO --> DE
  DG --> DE
  DE --> CT
  DE --> DC
  DE --> WP
  DE --> PI
  PI --> PU
  PI --> HY1
  PI --> HY2
  PI --> HY3
  PI --> HY4
  PI --> WB1
  PI --> WB2
  PI --> WB3
  PI --> TH1
  PI --> TH2
  PI --> TH3
  PI --> TH4
  PI --> TH5
  PU --> OS

  %% Click Events
  click IS "https://github.com/geodearc/geodots/blob/main/install.sh"
  click MG "https://github.com/geodearc/geodots/blob/main/Installation/main-guidedinstall.sh"
  click IO "https://github.com/geodearc/geodots/blob/main/Installation/install-options.sh"
  click IP "https://github.com/geodearc/geodots/blob/main/Installation/install-packages.sh"
  click TR "https://github.com/geodearc/geodots/blob/main/Installation/troubleshooter.sh"
  click CT "https://github.com/geodearc/geodots/tree/main/.config/"
  click DC "https://github.com/geodearc/geodots/tree/main/Dots/Config/"
  click DG "https://github.com/geodearc/geodots/tree/main/Dots/Guide/"
  click DO "https://github.com/geodearc/geodots/tree/main/Dots/Options/"
  click DE "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/Settings/settings.sh"
  click PI "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/postinstall.sh"
  click PU "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/postupgrade.sh"
  click HY1 "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/Hyprland/mediaexec.sh"
  click HY2 "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/Hyprland/mediatoggle.sh"
  click HY3 "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/Hyprland/startup.sh"
  click HY4 "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/Hyprland/wall.sh"
  click WB1 "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/Waybar/waybar.sh"
  click WB2 "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/Waybar/waybaropt.sh"
  click WB3 "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/Waybar/waybartoggle.sh"
  click TH1 "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/Themes/s-col.sh"
  click TH2 "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/Themes/s-min.sh"
  click TH3 "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/Themes/s-mod.sh"
  click TH4 "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/Themes/t-dark.sh"
  click TH5 "https://github.com/geodearc/geodots/blob/main/Dots/Scripts/Themes/t-light.sh"
  click WP "https://github.com/geodearc/geodots/tree/main/Dots/Wallpapers/"
  click RD "https://github.com/geodearc/geodots/blob/main/README.md"

  %% Styles
  classDef external fill:#f9f,stroke:#333,stroke-width:1px
  classDef system fill:#ccf,stroke:#333,stroke-width:1px
  classDef local fill:#cfc,stroke:#333,stroke-width:1px
  classDef decision fill:#fcf,stroke:#333,stroke-width:1px
```
