Dotfiles

<div align="center">

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

<h1>🏠 HorneroConfig</h1> <h3>✨ The Ultimate Linux Desktop Configuration Framework ✨</h3> <p><strong>Intelligent • Beautiful • Powerful • Seamless</strong></p>

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

<div align="center"> <a href="https://github.com/ulises-jeremias/dotfiles-template"> <img src="./static/template-banner.svg" alt="Template Repository Available - Click to use HorneroConfig Template" width="800"/> </a> </div> <div align="center"> <a href="https://github.com/ulises-jeremias/dotfiles/tree/x11-openbox-i3wm-xfce4"> <img src="./static/x11-branch-banner.svg" alt="Looking for X11 with i3, OpenBox, XFCE4? Check our X11 branch!" width="800"/> </a> </div> <div align="center"> <a href="https://github.com/ulises-jeremias/dotfiles/tree/wayland-hyprland-waybar-rofi-eww"> <img src="./static/wayland-legacy-branch-banner.svg" alt="Looking for the classic Wayland stack (Hyprland + Waybar + Rofi + EWW)? Check this branch!" width="800"/> </a> </div>

</div>

---

🌟 What is HorneroConfig?

<img alt="HorneroConfig Collage" align="right" width="400px" src="./static/collage.png"/>

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

<br clear="right"/>

---

🎨 Gallery

<details> <summary>🖼️ <b>Click to view screenshots</b></summary> <div align="center">

🌙 Dark Theme

<img src="./static/screen.png" alt="Dark Theme" width="800px"/>

☀️ Light Theme

<img src="./static/screen-2.jpg" alt="Light Theme" width="800px"/>

🚀 Application Launchers

<img src="./static/screenshot-launchpad.png" alt="Application Launcher" width="400px"/> <img src="./static/screenshot-spotlight-dark.png" alt="Spotlight Dark" width="400px"/>

</div> </details>

---

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

<details> <summary>🛠 <b>More installation methods</b></summary>

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

</details>

---

💎 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

<div align="center">

🌟 Contributors

<a href="https://github.com/ulises-jeremias/dotfiles/contributors"> <img src="https://contrib.rocks/image?repo=ulises-jeremias/dotfiles" alt="Contributors" /> </a> </div>

---

🙏 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 s