Remove GTK styling support

Author: bjarneo

app.go

@@ -111,6 +111,9 @@ func newSeededState() *theme.ThemeState {
 func (a *App) startup(ctx context.Context) {
 	a.ctx = ctx
 	_ = platform.EnsureAllDirs()
+	if err := theme.RetireLegacyGTKStylesheets(); err != nil {
+		log.Printf("retire legacy GTK stylesheets: %v", err)
+	}
 	if err := installDefaultWallpapers(); err != nil {
 		log.Printf("install default wallpapers: %v", err)
 	}
@@ -889,7 +892,7 @@ type ExportThemeRequest struct {
 // allExportableApps is the full set of app names that can be exported.
 var allExportableApps = map[string]bool{
 	"alacritty": true, "btop": true, "chromium": true, "colors": true,
-	"foot": true, "ghostty": true, "gtk": true, "hyprland": true, "hyprlock": true,
+	"foot": true, "ghostty": true, "hyprland": true, "hyprlock": true,
 	"icons": true, "kitty": true, "mako": true, "neovim": true,
 	"swayosd": true, "vencord": true, "vscode": true, "walker": true,
 	"warp": true, "waybar": true, "wofi": true, "zed": true,
@@ -946,7 +949,6 @@ func (a *App) ExportTheme(req ExportThemeRequest) (string, error) {
 	}
 
 	settings := theme.Settings{
-		IncludeGtk:    included["gtk"],
 		IncludeZed:    included["zed"],
 		IncludeVscode: included["vscode"],
 		IncludeNeovim: included["neovim"],

cli/cli.go

@@ -133,7 +133,6 @@ Theme generation:
     --light-mode                            Generate light variant
     --no-apply                              Render templates without activating
     --output <path>                         Output dir (defaults to ~/.config/aether/theme)
-    --gtk                                   Also render and install GTK CSS (default off)
     --no-zed                                Skip Zed extension (default on)
     --no-vscode                             Skip VSCode integration (default on)
     --no-neovim                             Skip Neovim template (default on)

cli/generate.go

@@ -10,6 +10,13 @@ import (
 )
 
 func runGenerate(args []string, templatesFS embed.FS) int {
+	for _, arg := range args {
+		if arg == "--gtk" || arg == "--no-gtk" {
+			fmt.Fprintf(os.Stderr, "Error: Unknown option: %s\n", arg)
+			return 1
+		}
+	}
+
 	// Parse flags
 	mode, args := parseFlag(args, "--extract-mode")
 	if mode == "" {
@@ -19,23 +26,16 @@ func runGenerate(args []string, templatesFS embed.FS) int {
 	noApply, args := hasFlag(args, "--no-apply")
 	outputPath, args := parseFlag(args, "--output")
 
-	// App include toggles. GTK is opt-in because it rewrites ~/.config/gtk-*/
-	// which many users have customised by hand. Everything else (zed, vscode,
-	// neovim) is opt-out and matches the GUI's default behaviour when those
-	// integrations are present.
-	includeGtk, args := hasFlag(args, "--gtk")
-	noGtk, args := hasFlag(args, "--no-gtk")
+	// Editor integrations are opt-out and match the GUI defaults.
 	noZed, args := hasFlag(args, "--no-zed")
 	noVscode, args := hasFlag(args, "--no-vscode")
 	noNeovim, args := hasFlag(args, "--no-neovim")
-	_ = noGtk // gtk default is already off; flag exists for symmetry
 
 	if len(args) == 0 {
 		fmt.Fprintln(os.Stderr, "Error: Wallpaper path is required")
-		fmt.Fprintln(os.Stderr, "Usage: aether --generate <wallpaper> [--extract-mode <mode>] [--light-mode] [--no-apply] [--output <path>] [--gtk] [--no-zed] [--no-vscode] [--no-neovim]")
+		fmt.Fprintln(os.Stderr, "Usage: aether --generate <wallpaper> [--extract-mode <mode>] [--light-mode] [--no-apply] [--output <path>] [--no-zed] [--no-vscode] [--no-neovim]")
 		return 1
 	}
-
 	wallpaperPath := args[0]
 
 	// Validate mode
@@ -100,7 +100,6 @@ func runGenerate(args []string, templatesFS embed.FS) int {
 	}
 
 	settings := theme.Settings{
-		IncludeGtk:    includeGtk,
 		IncludeZed:    !noZed,
 		IncludeVscode: !noVscode,
 		IncludeNeovim: !noNeovim,

cli/generate_test.go

@@ -0,0 +1,52 @@
+package cli
+
+import (
+	"embed"
+	"io"
+	"os"
+	"strings"
+	"testing"
+)
+
+func TestRunGenerateRejectsRemovedGTKOptions(t *testing.T) {
+	for _, args := range [][]string{
+		{"wallpaper.png", "--gtk"},
+		{"wallpaper.png", "--no-gtk"},
+		{"--gtk", "wallpaper.png"},
+		{"wallpaper.png", "--output", "--gtk"},
+	} {
+		got, stderr := captureGenerateStderr(t, func() int {
+			return runGenerate(args, embed.FS{})
+		})
+		if got != 1 {
+			t.Errorf("runGenerate(%q) = %d, want 1", args, got)
+		}
+		if !strings.Contains(stderr, "Error: Unknown option:") {
+			t.Errorf("runGenerate(%q) stderr = %q, want unknown option error", args, stderr)
+		}
+	}
+}
+
+func captureGenerateStderr(t *testing.T, run func() int) (int, string) {
+	t.Helper()
+	r, w, err := os.Pipe()
+	if err != nil {
+		t.Fatal(err)
+	}
+	original := os.Stderr
+	os.Stderr = w
+	defer func() { os.Stderr = original }()
+
+	code := run()
+	if err := w.Close(); err != nil {
+		t.Fatal(err)
+	}
+	output, err := io.ReadAll(r)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if err := r.Close(); err != nil {
+		t.Fatal(err)
+	}
+	return code, string(output)
+}

docs/blueprints.md

@@ -64,8 +64,7 @@ Blueprints are JSON files at:
     "contrast": 5
   },
   "settings": {
-    "includeNeovim": true,
-    "includeGtk": false
+    "includeNeovim": true
   }
 }
 ```

docs/standalone.md

@@ -21,7 +21,6 @@ When you click "Apply Theme", Aether generates all theme files to:
 ├── hyprland.conf         # Hyprland color config
 ├── kitty.conf            # Kitty terminal theme
 ├── waybar.css            # Waybar stylesheet
-├── gtk.css               # GTK theme (if enabled)
 ├── colors.toml           # Palette source (read by Aether's own UI)
 ├── neovim.lua            # Neovim colorscheme (if enabled)
 ├── vscode.json           # VSCode color theme (if enabled)
@@ -91,14 +90,6 @@ Or add to your Hyprland config:
 exec-once = swaybg -i ~/.config/aether/theme/backgrounds/wallpaper.jpg -m fill
 ```
 
-## GTK Theming
-
-If you enable "GTK Theme" in settings, Aether copies `gtk.css` to:
-- `~/.config/gtk-3.0/gtk.css`
-- `~/.config/gtk-4.0/gtk.css`
-
-This applies the color scheme to GTK applications system-wide.
-
 ## Automatic Reload
 
 For applications that support live reload, changes apply immediately. Others may require:

examples/custom/demo.txt

@@ -100,20 +100,7 @@ wallpaper_path = {wallpaper}
 # background = "0x{background.strip}"
 # foreground = "0x{foreground.strip}"
 
-# GTK CSS Example
-/*
-@define-color background {background};
-@define-color foreground {foreground};
-@define-color accent {magenta};
-
-window {
-    background-color: alpha(@background, 0.95);
-    color: @foreground;
-}
-*/
-
 # Kitty Example (uses RGB format)
 # background {background.rgb}
 # foreground {foreground.rgb}
 # black {black.rgb}
-

frontend/src/lib/components/layout/ActionBar.svelte

@@ -102,7 +102,6 @@
         {
             label: 'Desktop',
             apps: [
-                {key: 'gtk', name: 'GTK'},
                 {key: 'hyprland', name: 'Hyprland'},
                 {key: 'hyprlock', name: 'Hyprlock'},
                 {key: 'icons', name: 'Icons'},

frontend/src/lib/components/sidebar/TemplateToggles.svelte

@@ -18,12 +18,6 @@
 
     const specialToggles = [
         {key: 'includeNeovim', label: 'Neovim'},
-        {
-            key: 'includeGtk',
-            label: 'GTK',
-            description:
-                'Writes ~/.config/gtk-{3,4}.0/gtk.css. Switching themes outside Aether leaves this applied — click Revert to undo.',
-        },
         {key: 'includeZed', label: 'Zed'},
         {key: 'includeVscode', label: 'VS Code'},
     ] as const;
@@ -48,21 +42,9 @@
     });
 </script>
 
-{#snippet toggleRow(
-    label: string,
-    on: boolean,
-    onflip: () => void,
-    description?: string
-)}
+{#snippet toggleRow(label: string, on: boolean, onflip: () => void)}
     <label class="flex cursor-pointer items-center justify-between gap-3">
-        <div class="min-w-0">
-            <span class="text-fg-secondary text-[11px]">{label}</span>
-            {#if description}
-                <p class="text-fg-dimmed text-[9px] leading-snug">
-                    {description}
-                </p>
-            {/if}
-        </div>
+        <span class="text-fg-secondary text-[11px]">{label}</span>
         <button
             class="relative h-4 w-8 shrink-0 transition-colors duration-150
             {on ? 'bg-accent' : 'bg-bg-surface border-border border'}"
@@ -82,14 +64,10 @@
 <ExpandableSection title="Templates" bind:expanded={templatesOpen}>
     <div class="flex flex-col gap-2">
         {#each specialToggles as toggle}
-            {@render toggleRow(
-                toggle.label,
-                !!getSettings()[toggle.key],
-                () =>
-                    updateSettings({
-                        [toggle.key]: !getSettings()[toggle.key],
-                    }),
-                'description' in toggle ? toggle.description : undefined
+            {@render toggleRow(toggle.label, !!getSettings()[toggle.key], () =>
+                updateSettings({
+                    [toggle.key]: !getSettings()[toggle.key],
+                })
             )}
         {/each}
 

frontend/src/lib/constants/apps.ts

@@ -1,11 +1,10 @@
 import type {Settings} from '$lib/types/theme';
 
 // App keys that have a dedicated boolean flag in Settings. Toggling these
-// drives apply-side install steps (ApplyGTKTheme, ApplyZedTheme,
-// ApplyVSCodeTheme, SelectedNeovimConfig), not just template writing —
+// drives apply-side install steps (ApplyZedTheme, ApplyVSCodeTheme,
+// SelectedNeovimConfig), not just template writing —
 // they cannot be collapsed into the generic excludedApps list.
 export const SPECIAL_APP_FLAGS: Record<string, keyof Settings> = {
-    gtk: 'includeGtk',
     zed: 'includeZed',
     vscode: 'includeVscode',
     neovim: 'includeNeovim',
@@ -14,12 +13,7 @@ export const SPECIAL_APP_FLAGS: Record<string, keyof Settings> = {
 export const SPECIAL_APP_KEYS = new Set(Object.keys(SPECIAL_APP_FLAGS));
 
 // Order in which specials should appear in UI lists.
-export const SPECIAL_APP_ORDER: readonly string[] = [
-    'neovim',
-    'gtk',
-    'zed',
-    'vscode',
-];
+export const SPECIAL_APP_ORDER: readonly string[] = ['neovim', 'zed', 'vscode'];
 
 // Templates that are always written and never user-togglable. Hidden from
 // the Apps sidebar and the Targets strip. colors.toml is the canonical
@@ -30,7 +24,6 @@ export const ALWAYS_INCLUDED_APPS = new Set(['colors']);
 // Pretty labels for known templates. Anything not listed falls back to a
 // title-cased version of the key.
 const APP_LABELS: Record<string, string> = {
-    gtk: 'GTK',
     zed: 'Zed',
     vscode: 'VS Code',
     neovim: 'Neovim',