🚀 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
🎨 13 Beautiful Themes — Cyberpunk, Cozy, Vaporwave, Nature & more
⚡ 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 in the Hyprland + Quickshell ecosystem to significantly reduce installation time.

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

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

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 Quickshell, Hyprland, and scripts via Material Design 3
🔄 Live Updates — Colors refresh automatically when you change wallpapers

📖 Learn more about Smart Colors →

🎨 Rice System & Themes

Choose from 13 stunning themes organized by aesthetic: Cyberpunk, Cozy, Vaporwave, Nature, and Cosmic:

dots appearance list        # List available appearances 🎯
dots appearance apply flowers
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
🐚 Quickshell — Unified QML desktop shell (bar, launcher, dashboard, notifications, AI chat)
🐾 Kitty — GPU-accelerated terminal emulator
🐚 Zsh + Powerlevel10k — Feature-rich shell with beautiful prompt
🔒 Hyprlock — Secure lock screen
🖼️ Quickshell + wpgtk wallpaper flow — Unified wallpaper management via dots-wallpaper-set
🎨 Rice System — Instant theme switching with Material Design 3 colors

📖 Complete component list →

🛠️ Powerful Automation

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

dots --list             # List all available scripts
dots sysupdate          # Comprehensive system updates
dots smart-colors       # Intelligent color analysis
dots security-audit     # Security analysis and hardening
dots appearance apply neon-city

📂 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
🐚 Quickshell — Desktop shell configuration
🔧 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

🙏 Credits & Attribution

Quickshell Desktop Shell

The Quickshell implementation in HorneroConfig was highly inspired by and adapted from the amazing work of the caelestia-dots/shell project by @soramane.

• Original Project: caelestia-dots/shell
• License: GNU General Public License v3.0 (GPL-3.0)
• What we adapted: UI/UX design, desktop shell architecture, C++ plugin structure

The original GPL-3.0 license is preserved in home/dot_config/quickshell/LICENSE. We are deeply grateful for the beautiful and functional desktop shell that inspired our implementation.