Hyprland Dotfiles
A comprehensive, modular dotfiles configuration designed for Arch Linux and Arch-based distributions. This setup provides a complete, aesthetically pleasing desktop environment powered by Hyprland with carefully selected applications and tools.Experimental Status: This configuration is actively developed and may contain breaking changes. Always review changes before updating.
What’s Included
This dotfiles collection provides a complete desktop environment with the following components:Hyprland Window Manager
Modern Wayland compositor with smooth animations and efficient workspace management
Neovim Editor
LazyVim-based configuration with LSP support and modern plugin ecosystem
Kitty Terminal
GPU-accelerated terminal with custom themes and keybindings
Waybar Status Bar
Customizable status bar with system monitoring and workspace indicators
Key Features
Modular Configuration
Organized structure with separate modules for window manager, applications, and system settings
Automated Installation
Single command installation using Dotbot with automatic package management via Paru
Coordinated Theming
Consistent visual design across all applications and components
Developer-Focused
Optimized for development workflows with modern tooling and shortcuts
System Requirements
Operating System
Operating System
- Primary: Arch Linux
- Tested on: EndeavourOS
- Compatible: Other Arch-based distributions
Package Managers
Package Managers
- Pacman: Official Arch package manager (required)
- Paru: AUR helper for community packages (installed automatically)
Prerequisites
Prerequisites
- Git for cloning the repository
- Internet connection for package installation
- Basic familiarity with terminal usage
Quick Start
Get up and running in minutes with these simple steps: The installation script will automatically:- Install missing packages from
packages.txt - Create necessary directories
- Symlink configuration files to the appropriate locations
Repository Structure
The dotfiles are organized into logical sections:home/— Files that must exist in$HOME(.zshenv,.bashrc, etc.)dots/— WM-agnostic application configs (Code, Kitty, Fastfetch, Neovim)hyprland/— Wayland/Hyprland ecosystem (replaceable with other window managers)system/— OS-level configuration in~/.config
Explore the Structure
Learn about the detailed directory organization and file purposes
Next Steps
Installation Guide
Detailed installation instructions and system setup
Quick Start
Get productive immediately with essential configurations
Customization
Personalize your setup to match your preferences
Keybindings
Master the keyboard shortcuts and window management