# f1rul4yx/install_arch_linux_and_customize architecture

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

- Interactive diagram: https://gitdiagram.com/f1rul4yx/install_arch_linux_and_customize
- Repository: https://github.com/f1rul4yx/install_arch_linux_and_customize

## Overview

##### Project’s Nature and Purpose
- Project Type: It functions as a step-by-step installation and configuration guide (an “arch installation script/manual”).

##### Document’s Structure
- The README is organized into major sections:
- Installing Arch Linux – covers everything from keyboard layout, disk partitioning, formatting, mounting, base system installation, chrooting, essential package installation, locale/hostname configuration, and bootloader setup.
- Installing the Graphical Environment – includes setting up user-level configuration for bspwm, sxhkd, kitty, zsh (with oh-my-zsh and powerlevel10k) plus polybar customizations and associated support scripts (scripts for network, battery, etc.).
- Additional Software and Features – provides a list of recommended extra packages and noteworthy commands.
- Although there is only one file provided (the README), its organization gives clear “phases” in the system installation/configuration process.

##### Main Components
a. Core System Installation Phase:
- Hardware/Boot Preparations: Loading the Spanish keyboard layout, connecting to Wi-Fi.
- Disk Partitioning and Formatting: Highlight partitions for root (/), home, boot, and swap.
- Mounting Partitions and Installing the Base System (pacstrap of base packages, kernel, firmware).
- Generating fstab and chrooting.
- Configuring system essentials: time, locale, hostname, initramfs generation.
- Bootloader Installation (GRUB with EFI configuration).
b. Graphical Environment Setup Phase:
- User Environment Creation: Creating a new user, configuring Sudoers.
- Essential Packages Installation: Installing git, p7zip, zsh, kitty, bspwm, sxhkd, polybar, picom, dmenu, and others.
- Service Setup: Enabling LightDM, NetworkManager, and configuring them.
- Desktop Environment Customization: Configurations for bspwm, sxhkd, and kitty.
- Terminal and Shell Custom Setup: ZSH installation (oh-my-zsh and powerlevel10k with zsh-syntax-highlighting enhancements).
c. Custom Scripts and Polybar Configurations:
- Directory and Script Setup: Various scripts for target IP, network interfaces (wlan, ethernet, HTB), and battery status.
d. Additional Software and Final System Touches:
- Listing of extra software (e.g., browsers, editors, multimedia, backup utilities).
- Extra instructions like enabling time synchronization.

##### Determining Relationships and Interactions
- Think of the installation as a sequential flow: Starting from pre-installation checks (keyboard, Wi-Fi) then moving through disk and base system configuration, to bootloader setup and finally customization of the desktop environment.
- Each phase relies on the previous one being successfully executed. For example, the graphical environment phase is dependent on proper base system installation and user creation.

##### Highlighting Architectural Patterns or Design Principles
- Modularity: Although it is a linear installation guide, the segmentation into phases (base install vs. graphical environment vs. additional software) shows a modular approach.
- Customization/Extensibility: The guide shows multiple “custom scripts” each handling a specialized task (network, battery, target IP handling). Illustrate them as independent nodes that feed into the overall desktop status display (Polybar).
- Service Enabling: Emphasize systemd services (LightDM, NetworkManager) as components that automatically manage important background tasks.

## Diagram (Mermaid)

```mermaid
flowchart TD
    preSetup["Pre-installation Setup: Keyboard & Wi‑Fi"]:::pre
    coreInstall["Core System Installation Phase"]:::core
    diskPart["Disk Partitioning & Formatting"]:::core
    baseSys["Mounting & Base System Installation"]:::core
    sysEssentials["System Essentials: fstab, chroot, Time/Locale, Bootloader"]:::core
    userSetup["User Setup: Create User & Sudoers"]:::core
    guiInstall["Graphical Environment Setup Phase"]:::gui
    desktopEnv["Desktop Environment: bspwm, sxhkd, picom, LightDM"]:::gui
    terminalShell["Terminal & Shell: kitty, zsh, oh‑my‑zsh, powerlevel10k"]:::gui
    customScripts["Custom Scripts and Polybar Configurations"]:::custom
    additionalSoft["Additional Software and Final System Touches"]:::additional

    preSetup --> coreInstall
    coreInstall --> diskPart
    diskPart --> baseSys
    baseSys --> sysEssentials
    sysEssentials --> userSetup
    userSetup --> guiInstall
    guiInstall --> desktopEnv
    desktopEnv --> terminalShell
    terminalShell --> customScripts
    customScripts --> additionalSoft

    click coreInstall "https://github.com/f1rul4yx/install_arch_linux_and_customize/blob/main/README.md"
    click guiInstall "https://github.com/f1rul4yx/install_arch_linux_and_customize/blob/main/README.md"
    click customScripts "https://github.com/f1rul4yx/install_arch_linux_and_customize/blob/main/README.md"
    click additionalSoft "https://github.com/f1rul4yx/install_arch_linux_and_customize/blob/main/README.md"

    classDef pre fill:#FFDFBA,stroke:#333,stroke-width:2px;
    classDef core fill:#BAE1FF,stroke:#333,stroke-width:2px;
    classDef gui fill:#BAFFC9,stroke:#333,stroke-width:2px;
    classDef custom fill:#FFE6A7,stroke:#333,stroke-width:2px;
    classDef additional fill:#D1BAFF,stroke:#333,stroke-width:2px;
```
