~/.dotfiles/

A comprehensive repository containing all files and configurations to restore and reproduce my OS & development environment(s).

• Operating systems
• Scripts & Utilities
• Installation

What are dotfiles?

User-specific application configuration is traditionally stored in so called dotfiles (files whose filename starts with a dot). It is common practice to track dotfiles with a version control system such as Git to keep track of changes and synchronize dotfiles across various hosts.

Reference: Arch Linux | Dotfiles

---

Operating systems

Each OS folder contains specific configurations, scripts, and installation instructions.

Note: shared shell configs and repo-wide config live outside OS folders:

• shell/ (e.g. .bash_profile)
• common/ (e.g. .editorconfig)

• macOS
• Fedora

Scripts & Utilities

View all scripts/utilities and how to use them by running:

make help

Note: When using make to execute script-wrapper targets, pass arguments like:

make <target> ARGS="<args to pass to script>"

OR:

make <target> -- <args to pass to script>

Installation

Clone the repository

SSH (alternative)

Cloning with SSH requires that you have your SSH keys set up with GitHub.

See Connecting to GitHub with SSH for instructions

git clone git@github.com:clxrityy/dotfiles.git ~/.dotfiles

Using HTTPS (recommended for most users)

# Clone the repository (HTTPS)
git clone https://github.com/clxrityy/dotfiles.git ~/.dotfiles
# Navigate to the dotfiles directory
cd ~/.dotfiles

Run the installation script

# Show help
bash install.sh --help

# Run installation as a dry-run with verbose output
bash install.sh --dry-run --verbose

# Run installation (auto-detects OS, runs GNU Stow, then runs OS-specific steps)
bash install.sh

---

TO-DO

• CI
• Windows
• Raspberry Pi
• Ventoy USB setup
• Package migration script
• Development-specific environments
• VPN configurations
• SSH config management
• Container setups (Docker)