A unified, modular, zero-drift dotfiles and bootstrap system delivering an identical developer experience across Arch Linux, Ubuntu, macOS, and Fedora.
The repository decouples universal tools from desktop environments, distro-specific package installers, and recovery runbooks:
graph TD
Sync["π sync.sh (Auto-Detector & Linker)"]
Core["π core/<br/>(Universal Shell, Neovim, Ghostty, Herdr, Starship, Yazi)"]
Desktop["π₯οΈ desktop/<br/>(GNOME, KDE Plasma, Hyprland Lua/Classic)"]
Distros["π¦ distros/<br/>(Arch, Ubuntu, macOS, Fedora, OmArchy)"]
Troubleshoot["π©Ί troubleshoot/<br/>(GRUB, Dual-Boot, Toolchain fixes)"]
Sync --> Core
Sync --> Desktop
Sync --> Distros
Sync --> Troubleshoot
core/β Universal app configs (nvim,ghostty,herdr,yazi,starship), shell dotfiles, and automated setup.desktop/β Modular DE configurations for GNOME (dconf/extensions), KDE Plasma, and Hyprland.distros/β Distro-native package installation, systemd services, and hardware optimizations.troubleshoot/β Self-contained recovery guides & executable repair scripts for GRUB, dual-boot, and compilers..agents/skills/β Guardian skill (archconfig-guard) preventing multi-distro breakage.
git clone --depth 1 https://github.com/Codesmith28/archConfig.git ~/archConfig
cd ~/archConfigImportant
Zero configuration required: ./sync.sh automatically detects your operating system (Arch, Ubuntu, macOS, Fedora) and active desktop environment (GNOME, KDE, Hyprland, or headless).
# Preview changes safely without touching files
./sync.sh --dry-run
# Run auto-detection & link dotfiles
./sync.shπ§ Need manual overrides? (Click to expand)
Override detection when configuring a secondary environment or container:
# Arch Linux with Hyprland
./sync.sh --distro arch --de hyprland
# Ubuntu with GNOME
./sync.sh --distro ubuntu --de gnome
# macOS Terminal Workstation
./sync.sh --distro mac --de none
# Fedora Workstation with GNOME
./sync.sh --distro fedora --de gnome- π Dynamic C++26 Discovery: Auto-detects the newest installed GCC/G++ across Linux and macOS Homebrew, exports
$CC/$CXX, and providesrun_cppfor instant builds. - β‘ Unified LazyVim: Out-of-the-box LSP support for Python (
pyrefly), C/C++ (clangd), dynamic JDK resolution (resolve_java_home()), and competitive programming test runner. - π Isolated Multi-Profile Git & SSH: Automatically rewrites HTTPS to SSH and scopes identities (e.g. work vs personal) by directory without credential leaks (
core/scripts/setup_git.sh). - π Modern Shell Stack: Unattended bootstrap for
zoxide,fzf,yazi,starship, andvim-plugwithout dirtying tracked files (core/setup.sh).
Run native system package installers and hardware drivers on clean machines:
- Arch Linux:
cd distros/arch && bash setup.shβ Pacman packages, AUR helper setup, and system services. - Ubuntu:
cd distros/ubuntu && bash setup.shβ APT dependencies, PPA repositories, and desktop optimizations. - macOS:
cd distros/mac && bash setup.shβ Homebrew bundle, CLI utilities, and cask applications. - Fedora:
cd distros/fedora && bash setup.shβ DNF packages, RPM Fusion, developer toolchains, and NVIDIA configuration.
- π§ KDE Plasma Setup Guide: Fix shortcut persistence (
kglobalshortcutsrc), Plasma 6 migration, and window routing. - π¨ GNOME Setup Guide: Fix DBus session attachment, GSettings compilation, and Ubuntu dock collisions.
- π₯Ύ GRUB Recovery Guide & Auto-Repair Script: Restore EFI boot entries and dual-boot entries after Windows updates.
- π macOS
<bits/stdc++.h>Fix: Resolve missing C++ bits headers on Darwin for competitive programming.
- Controlled by archconfig-guard to enforce cross-platform compatibility rules.
- Never hardcodes compiler versions or platform-exclusive commands in
core/. - For historical context and design decisions, see MIGRATION.md.