#+TITLE: Tonarchy
#+AUTHOR: Tony, btw
#+OPTIONS: toc:2 num:nil

* Tonarchy

A zero-dependency Arch Linux installer with a clean TUI built from scratch in C.

*Status:* Alpha - Beginner (XFCE) and Suckless modes functional, Wayland (Niri) coming soon

* Philosophy

Tonarchy is designed to take users from *zero to hero* with an opinionated beginner mode that sets up a complete, working Linux desktop environment. No choices, no confusion - just a solid foundation to start learning.

For experienced users, the suckless mode provides a minimal dwm setup.

* Installation Modes

** Beginner (XFCE)
Opinionated setup with XFCE desktop, essential applications, and sane defaults. Perfect for your first Linux installation.

** Tony-Suckless (dwm)
Minimal setup with dwm, st, and dmenu built from source. For users who want a lightweight tiling experience.

** Oxidized (Coming Soon)
Wayland-native setup with Niri compositor. Modern, secure, and efficient.

* Keybindings

** General (XFCE Beginner Mode)

| Key              | Action                |
|------------------+-----------------------|
| Super+Return     | Terminal (Alacritty)  |
| Super+d          | App Launcher (Rofi)   |
| Super+e          | File Manager (Thunar) |
| Super+q          | Close Window          |
| Super+f          | Maximize Window       |
| Super+Shift+f    | Fullscreen            |

** Window Management

| Key              | Action                |
|------------------+-----------------------|
| Super+j          | Cycle Windows         |
| Super+k          | Cycle Windows Reverse |
| Super+Left       | Tile Left             |
| Super+Right      | Tile Right            |
| Super+Up         | Tile Up               |
| Super+Down       | Tile Down             |

** Workspaces

| Key              | Action                |
|------------------+-----------------------|
| Super+1-9        | Switch to Workspace   |
| Super+Shift+1-9  | Move Window to WS     |
| Super+Tab        | Next Workspace        |
| Super+Shift+Tab  | Previous Workspace    |

* Technical Highlights

- *Zero dependencies* :: Raw terminal control using termios + ANSI codes (no ncurses)
- *Single C file* :: Entire installer in ~1500 lines of C
- *Fuzzy finding* :: fzf integration for keyboard and timezone selection
- *Static binary* :: Ships as a single static executable on the ISO

* Requirements

- UEFI system
- Internet connection
- Boot from Tonarchy ISO

* Beginner Mode Setup

The beginner installation handles everything:

** Desktop Environment
- XFCE with preconfigured keybindings
- Autologin via getty (no display manager)
- Adwaita-dark theme

** Applications
- Firefox (with uBlock Origin, Dark Reader)
- Neovim
- Alacritty terminal
- Thunar file manager
- VLC media player
- Rofi launcher

** System Configuration
- Locale: =en_US.UTF-8=
- Timezone: User selected via fzf
- Keyboard: User selected via fzf
- NetworkManager enabled
- Sudo configured for wheel group

** Disk Layout
- 1GB FAT32 EFI partition
- 4GB swap partition
- Remaining space for ext4 root

* Roadmap

- [X] XFCE Beginner Mode
- [X] Suckless Mode (dwm/st/dmenu)
- [ ] Niri Wayland Mode
- [ ] Encrypted disk support
- [ ] Multi-disk configurations

* Building

#+BEGIN_SRC bash
make
#+END_SRC

* License

GPL