Celestial Shade

Minimal and Cozy by default. Powerful when needed.

📚 Read the Documentation

Full installation guide, customization details, and API references are available on official site.

shadowdevforge.github.io/CelestialShade-Config

---

💎 Philosophy

Celestial Shade is not just a dotfiles repository; it is a Desktop Environment built on Hyprland.

It rejects the standard "shell script spaghetti" found in most configurations in favor of a robust Lua Object-Oriented Architecture.

✨ Key Features

• 🔮 The Lua Engine: A central compiler (main.lua) that reads raw data tables and generates valid config artifacts for Hyprland, Waybar, Rofi, and Ghostty instantly.
• 🏝️ Dynamic Islands: A reactive Waybar configuration with expanding drawers for screenshots, power management, and dashboards.
• 🧠 State Awareness: The wallpaper engine has memory. It remembers exactly which image you were using for each specific theme.
• ⚡ Native Performance: Zero reliance on heavy Python/Node daemons for UI. Everything is native C++ or lightweight Lua.
• 🎨 8 Universal Themes: Switch instantly between Catppuccin, Rose Pine, Nord, Synthwave, and more without reloading the OS.

🚀 Quick Start

For detailed instructions, visit the documentation.

One-line installation (Arch Linux):

# 1. Clone the repository
git clone https://github.com/shadowdevforge/CelestialShade-Config ~/.config/hypr

# 2. Enter directory
cd ~/.config/hypr

# 3. Run the Lua Installer
lua installation.lua

Showcase

Changing themes

2025-12-05.01-33-38.mp4

Waybar overview

2025-12-05.01-36-26.mp4

⌨️ Quick Keybindings

Key	Action
Super + T	Theme Switcher (Rofi Menu)
Super + W	Next Wallpaper (Cycles current theme folder)
Super + Return	Open Terminal (Ghostty)
Super + Space	Open App Launcher
Super + Print	Screenshot Menu
Super + .	Emoji Picker

---

_{CelestialShade forged}