🚀 NEVER SKIP THE README - YOUR JOURNEY STARTS HERE! 🚀

🏠 HorneroConfig

✨ The Ultimate Linux Desktop Configuration Framework ✨

Intelligent • Beautiful • Powerful • Seamless

📖 Documentation • 🎨 Gallery • 🚀 Quick Start • 🤝 Contributing

---

🌟 What is HorneroConfig?

HorneroConfig is a cutting-edge dotfiles framework that transforms your Linux desktop into a masterpiece of functionality and beauty. Named after the industrious hornero bird 🐦, renowned for its skillful nest-building, this framework empowers you to craft the perfect digital workspace.

✨ Highlights

🧠 Smart Color Intelligence — Automatic theme-aware color adaptation
🎨 12+ Beautiful Themes — Stunning pre-configured rice themes
⚡ One-Command Setup — From zero to hero in minutes
🌊 Hyprland/Wayland — Modern compositor with smooth animations
🔧 100+ Automation Scripts — Comprehensive tooling ecosystem
🛡️ Security-First — Built-in auditing and hardening
📦 Zero Maintenance — Powered by chezmoi for seamless updates

---

🎨 Gallery

🖼️ Click to view screenshots

🌙 Dark Theme

☀️ Light Theme

🚀 Application Launchers

---

🚀 Quick Installation

⚡ One-Line Install (Recommended)

sh -c "$(curl -fsSL "https://github.com/ulises-jeremias/dotfiles/blob/main/scripts/install_dotfiles.sh?raw=true")"

📦 Arch Linux (AUR)

yay -S dots-stable      # Stable release
yay -S dots-git         # Latest features

💡 Performance Tip: HorneroConfig automatically configures Chaotic-AUR during installation, providing precompiled binaries for popular AUR packages (Hyprland ecosystem, nwg-* tools, etc.) to significantly reduce installation time.

🛠 More installation methods

Using Chezmoi

chezmoi init --apply ulises-jeremias --source ~/.dotfiles

From Source

git clone https://github.com/ulises-jeremias/dotfiles ~/.dotfiles
~/.dotfiles/install.sh

Manual AUR Build

git clone https://aur.archlinux.org/dots-stable.git /tmp/dots-stable
cd /tmp/dots-stable && makepkg -si

---

💎 Key Features

🧠 Revolutionary Smart Colors System

Our game-changing smart colors technology automatically analyzes your color palette and intelligently selects optimal colors for UI elements:

✨ Semantic Intelligence — Error, success, warning, info colors that make sense
🎨 Theme Adaptation — Perfect contrast and readability on any background
⚡ Auto-Application — Instantly applies to Waybar, EWW, Hyprland, and scripts
🔄 Live Updates — Colors refresh automatically when you change wallpapers

📖 Learn more about Smart Colors →

🎨 Rice System & Themes

Choose from 12+ stunning themes spanning nature, retro, cyberpunk, and cosmic aesthetics:

dots rofi-rice-selector     # Interactive theme picker 🎯
dots rice apply flowers     # Apply a specific theme
dots rice list              # See all available themes

📖 Explore all themes →

🔧 Core Stack

🌊 Hyprland — Dynamic tiling Wayland compositor
📊 Waybar — Beautiful dual-bar status bar with 20+ modules
🚀 Rofi — Lightning-fast app launcher (Wayland fork)
🔔 Mako — Lightweight notification daemon
🐾 Kitty — GPU-accelerated terminal emulator
🐚 Zsh + Powerlevel10k — Feature-rich shell with beautiful prompt
🎛️ EWW — Modern system widgets (dashboard & powermenu)
🔒 Hyprlock — Secure lock screen
🖼️ Hyprpaper — Fast wallpaper daemon
🎨 Rice System — Instant theme switching

📖 Complete component list →

🛠️ Powerful Automation

Access 100+ built-in scripts via the dots command:

dots scripts            # Interactive script browser
dots sysupdate          # Comprehensive system updates
dots smart-colors       # Intelligent color analysis
dots security-audit     # Security analysis and hardening
dots rofi-rice-selector # Visual theme picker

📂 dots-eject — Export configs for manual use
🔄 dots-update — Sync with upstream changes

📖 Scripts documentation →

---

🧪 Development & Testing

🎮 Safe Testing Environment

Try HorneroConfig risk-free with our Vagrant playground:

git clone https://github.com/ulises-jeremias/dotfiles && cd dotfiles
./bin/play                        # Start VM
./bin/play --provision hyprland   # Provision with Hyprland
./bin/play --remove               # Clean up

📖 Testing guide →

🔧 Contributing

We use pre-commit for code quality:

pipx install pre-commit           # Install pre-commit
cd ~/.dotfiles && pre-commit install   # Set up hooks
pre-commit run --all-files        # Run all checks

🤝 Contributing guide → | Development standards →

---

📖 Documentation

📚 For Users

🏠 Getting Started — First steps and basic setup
🎨 Rice System — Theme management
🧠 Smart Colors — Intelligent theming
📊 Waybar — Status bar configuration
🎛️ EWW Widgets — System widgets
🔧 Scripts — Automation tools
🛡️ Security — Privacy and security

🤖 For Developers & AI Agents

📋 AGENTS.md — Quick reference guide
🏗️ Architecture — Design principles
📐 ADRs — Architecture decisions
🔒 Security — Security practices
⚡ Performance — Optimization strategies

---

🌍 Platform Support

🐧 Arch Linux — Full support with AUR packages
🐧 Ubuntu/Debian — Supported (manual dependencies)
🐧 Fedora/RHEL — Supported (manual dependencies)
☁️ Cloud Dev — GitHub Codespaces, Gitpod, VS Code Remote

📖 Platform-specific guides →

---

🤝 Contributing

We welcome all contributions! 🎉

🐛 Bug reports • ✨ Feature requests • 🎨 New themes • 📚 Documentation • 🔧 Code

🌟 Contributors

---

💝 Show Your Support

If HorneroConfig has improved your Linux experience:

⭐ Star this repo • 🐦 Share it • 🤝 Contribute

🏠 HorneroConfig
Building the perfect digital nest, one configuration at a time

_{Licensed under MIT License • Made with ❤️ for the Linux community}