Developer Documentation Directory
Welcome to the Windhawk Themes Documentation Guides. These comprehensive technical guides cover the architecture, surface guides, companion tools, and quality gates for engineering cohesive Windows 11 themes.
🧭 Topic Guides
🌟 Overview & Architecture
- Getting Started Guide — Scaffolding workspaces, installing dependencies, and initializing themes.
- Architecture & Design Philosophy — Multi-mod design system, glass materials, and spatial token hierarchy.
🪟 Styler Surface Guides
- Start Menu Styler Guide — Start menu flyouts, pinned app grids, and companion cards.
- Taskbar Styler Guide — Floating taskbar frame, grouped task list button pills, system tray styling.
- Notification Center Styler Guide — Quick settings tiles, sliders, calendar flyout, toasts.
- Settings Styler Guide — Modern Settings app styling, cards, search box.
- File Explorer Styler Guide — WinUI 3 tab controls, address bar, breadcrumbs, search pills.
🧩 Companion & Utility Mods
- Companion Mods Overview — Companion mod integration guidelines and ecosystem map.
- Taskbar Utility Mods — Taskbar styling companions and system tray utilities.
- Shell Flyouts & Positions — Shell flyout positioning, margins, and anchor tweaks.
- System & Translucency Mods — DWM blur and system translucency companion guidelines.
🔍 Toolchain & Diagnostics
- Hybrid XAML Inspector — Native C++ TAP engine and Python CLI tools.
- Visual Tree Diagnostics — Querying elements, automated surface activation.
- UWPSpy Manual Inspection — Interactive GUI visual tree inspection guide.
📐 Standards & Quality Gates
- Style Syntax & Tokens — YAML syntax rules, strict constant ordering.
- Glass Material Recipes —
WindhawkBlurshaders,AcrylicBrushusage, rim gradients. - Target Evidence Protocol — Sourced selectors only from verified evidence.
- Verification & Quality Gates — Automated static test runner (
Test-WindhawkStyles.ps1).