Skip to content

About

πŸš€ Distros change, muscle memory shouldn't. Started on Arch, built for everywhere. Unified, zero-drift dotfiles & bootstrap across Arch, Fedora, Ubuntu, and macOS.

Resources

Stars

68 stars

Watchers

1 watching

Forks

Latest commit

Β 

History

448 Commits

Folders and files

Repository files navigation

πŸš€ archConfig

Platform Desktop Editor Terminal

Distros change, muscle memory shouldn't. Started on Arch, built for everywhere.

A unified, modular, zero-drift dotfiles and bootstrap system delivering an identical developer experience across Arch Linux, Ubuntu, macOS, and Fedora.


πŸ—οΈ Layered Architecture

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
Loading
  • 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.

⚑ Quick Start

1. Clone the repository

git clone --depth 1 https://github.com/Codesmith28/archConfig.git ~/archConfig
cd ~/archConfig

2. Synchronize dotfiles

Important

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

πŸ› οΈ Developer Toolchains & Features

  • πŸš€ Dynamic C++26 Discovery: Auto-detects the newest installed GCC/G++ across Linux and macOS Homebrew, exports $CC/$CXX, and provides run_cpp for 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, and vim-plug without dirtying tracked files (core/setup.sh).

πŸ“¦ Distribution Bootstrapping

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.

🩺 Troubleshooting Runbooks

  • 🐧 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.

πŸ€– AI Assistant Guidelines

  • 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.

About

πŸš€ Distros change, muscle memory shouldn't. Started on Arch, built for everywhere. Unified, zero-drift dotfiles & bootstrap across Arch, Fedora, Ubuntu, and macOS.

Resources

Stars

68 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages