# Repository Guidelines

This repository tracks some of the dotfiles for my Arch Linux installation.

## Architecture

- Each directory contains related (and ideally selfcontained) configuration files
- Makefile orchestrates each target

### Patterns and Principles

- **Symbolic linking**: Use symlinks rather than copying dotfiles
- **Modular organization**: Each application or unique setup has its own directory
- **Make-based automation**: The Makefile is the entrypoint that triggers all the subscripts
- **Theme consistency**: Catppuccin Frappe theme used across all applications that support it

## Coding Style & Naming Conventions

- Shell: `#!/usr/bin/env bash` with `set -euo pipefail`; hyphenated script names; keep functions small.
- Make: tabs for recipes; small, composable targets; reuse variables like `DOTFILES`.
- Configs: keep JSON/TOML valid and minimal.