Home

BrewLand Wiki: Introduction

Welcome to the BrewLand wiki. This documentation provides a comprehensive guide to understanding, installing, and customizing the BrewLand Hyprland environment.

What is BrewLand?

BrewLand is a refined, aesthetic-first Hyprland configuration designed for users who value a minimalist workflow, smooth animations, and consistent system-wide theming. It is built on the Catppuccin color palette (Mocha and Latte flavors) and emphasizes modularity and ease of maintenance.

Core Philosophy

1. Visual Excellence: Every component, from the bar to the notifications, is curated to look professional and cohesive.
2. Minimalist Efficiency: The layout is optimized for a "scrolling stack" (Master layout in Hyprland) but provides quick access to everything via specialized Rofi menus.
3. Dynamic Adaptability: Switch between Dark (Mocha) and Light (Latte) themes instantly with a single keybinding, affecting all supported applications.
4. Modular Design: Configurations are split into logical files, making it easy to tweak specific parts of the system without breaking others.

The BrewLand Stack

BrewLand is not just a Hyprland config; it's a collection of integrated tools:

• Window Manager: Hyprland (Wayland compositor)
• Status Bar: Waybar
• Notifications: SwayNC
• App Launcher & Menus: Rofi (Wayland fork)
• Terminal: Kitty
• Wallpaper Engine: SWWW
• Theme Switcher: Custom BrewLand bash scripts
• Health Check: brewland-doctor.sh

Navigation

To get started, follow these guides:

1. Installation: How to deploy BrewLand on your system.
2. Keybindings: The full list of shortcuts to master the environment.
3. Theming System: How to customize and toggle themes.
4. Component Guides: Technical deep-dives into Hyprland, Waybar, and Rofi.
5. Utility Tools: Documentation for the built-in helper scripts.

---

Maintained by BeetleBot.