sway

What problem does it solve?

This skill eliminates the tedious, error-prone process of manually configuring a Sway Wayland compositor session on NixOS, especially for developers working with Wails desktop apps or multi-GPU hardware, and prevents common configuration mistakes that break XDG portals, screen sharing, and application rendering.

Core Features & Use Cases

• Complete Sway Module Guidance: Covers all NixOS programs.sway options, including auto-wired services to avoid duplicate conflicting configurations.
• Multi-GPU Support: Provides vendor-specific configuration for Intel, AMD, and NVIDIA (including hybrid PRIME offload setups) with correct environment variable placement for Sway.
• Wails App Rendering Fixes: Resolves blank window and rendering glitches for webkit2gtk-based Wails applications on integrated and discrete GPUs.
• Animated Wallpaper Setup: Guides implementation of video and animated image wallpapers using wlroots-compatible tools like mpvpaper and awww.
• Use Case: A developer with a NixOS laptop featuring hybrid Intel/NVIDIA graphics can use this skill to configure a working Sway session with proper GPU offloading, functional Wails app rendering, and animated video wallpapers without manual trial and error.

Quick Start

Use the sway skill to generate a complete, working NixOS configuration for a Sway Wayland session with Wails app support and multi-GPU handling tailored to your hardware.