Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Introduction

Fern Shell is a modern, QML-based desktop shell for Hyprland. It provides a sleek status bar with live-reloadable components, designed for rapid iteration and easy customization.

Why Fern Shell?

Traditional BarsFern Shell
Recompile to change stylingLive reload on file save
Limited theming optionsFull design token system
Separate config languagesQML + TOML configuration
Complex build systemsNix flakes for reproducibility

Key Features

  • Live Reload: Change QML files and see updates instantly
  • Hyprland Native: Built specifically for Hyprland's layer-shell protocol
  • Design Tokens: Consistent theming with a three-tier token system
  • Minimal Dependencies: Qt6/QML frontend, optional Rust backend
  • Nix-First: Easy installation via Home-Manager or NixOS modules

Architecture at a Glance

┌─────────────────────────────────────┐
│         Fern Shell Package          │
├─────────────────────────────────────┤
│  QML/QuickShell Frontend            │
│  - Panel with modules               │
│  - Live-reloadable                  │
│  - System integration via D-Bus     │
├─────────────────────────────────────┤
│  Rust Service (fernctl)             │
│  - Configuration management         │
│  - Theme token generation           │
│  - File watching                    │
└─────────────────────────────────────┘

What's Next?