Designs

Paneflow liest den Top-Level-Wert "theme" aus paneflow.json. Die aktuell mitgelieferten Designs sind One Dark und PaneFlow Light. Wenn du den Schlüssel weglässt, auf null setzt oder in Settings zurücksetzt, nutzt Paneflow das Standarddesign One Dark.

TL;DR. Nutze Settings -> Themes in der UI, oder setze "theme": "One Dark" / "theme": "PaneFlow Light" in paneflow.json. Designänderungen laden nach dem Speichern heiß nach, ohne Neustart der App.

Wie wechsle ich das aktive Design?

Öffne Settings -> Themes und wähle eines der drei Segmente:

System wird heute nicht als dauerhaftes "folge dem OS"-Modus gespeichert. Nach der Auswahl schreibt Paneflow einen der konkreten Designnamen oben.

Du kannst paneflow.json auch direkt bearbeiten:

{
"$schema": "https://github.com/arthjean/paneflow/raw/main/schemas/paneflow.schema.json",
"$schemaVersion": "1.0.0",
"theme": "PaneFlow Light"
}

Die Konfigurationsdatei liegt hier:

Das Schema listet die kanonischen Schreibweisen. Zur Laufzeit ist die Namenssuche nicht groß-/kleinschreibungssensibel, aber die kanonischen Namen halten Autocomplete und Review-Diffs sauber. Unbekannte Namen fallen auf One Dark zurück und geben beim nächsten Parsen eine Log-Warnung aus. Die vollständige Liste erkannter Schlüssel steht im Konfigurationsschema.

Welche Designs werden heute mit Paneflow ausgeliefert?

Stabil in aktuellen Builds.

Ein Paneflow-Design definiert 36 Terminal-Farbslots: eine 24-Farben-ANSI-Palette (8 Farbtöne x 3 Intensitäten: normal, hell, gedimmt), 5 Basisfarben für Hintergrund/Vordergrund, Cursor, Auswahl plus abgeleiteten Auswahlvordergrund, Scrollbar-Thumb, Linktext und 2 Titelleistenfarben. Paneflow hält außerdem eine separate Syntaxpalette für die Diff-Oberfläche.

Der Auswahlvordergrund wird nicht manuell abgestimmt. Paneflow berechnet ihn beim Laden des Designs neu, bis APCA Lc >= 45 gegenüber dem Auswahlhintergrund erreicht ist, damit ausgewählter Text lesbar bleibt.

Was beeinflusst ein Design?

Designs ändern mehr als die ANSI-Farben des Terminals:

• Terminalhintergrund, Vordergrund, Cursor, Auswahl, Scrollbar, Links und ANSI-Palette;
• die vom aktiven Design abgeleitete App-Chrome-Palette;
• Markdown-Panes und Tabellen;
• Syntaxfarben in Diff und Review;
• Titelleiste und native Materialien auf unterstützten Plattformen.

Zwei verwandte Einstellungen sind vom Designnamen getrennt:

• terminal.cursor_color überschreibt nur den Terminalcursor. null nutzt die Cursorfarbe des aktiven Designs.
• commands[].workspace.color ist eine Workspace-Template-Farbe, kein Designakzent.

Wie funktioniert der Design-Hot-Reload?

Wenn du paneflow.json speicherst, löst Paneflow das aktive Design neu auf. Kein Neustart und kein Fenster-Reload sind nötig.

Zwei Mechanismen treiben den Reload:

• Ereignisgesteuerter Pfad. Ein notify-Watcher überwacht den Konfigurationsordner und debounced Datei-Events um 300 ms.
• Polling-Fallback. Wenn der OS-Watcher nicht starten kann, fällt Paneflow auf einen 500-ms-mtime-Poll zurück.

Die neue Palette erscheint im nächsten Render-Frame, nachdem Watcher oder Fallback ausgelöst wurden. Wenn der Reload auf deiner Maschine stillschweigend scheitert, nennt die Troubleshooting-Seite die häufigsten Ursachen.

Design- und Typografie-Schlüssel laden heiß aus paneflow.json nach. Der Schlüssel window_decorations wird einmal beim Start gelesen, daher erfordert seine Änderung weiterhin einen Neustart von Paneflow.

Wie erstelle ich ein eigenes Design?

Benutzerdefinierte Design-Dateien werden noch nicht unterstützt. Paneflow lädt kein theme.json, und es gibt heute kein eigenes Palettenformat in paneflow.json.

Wenn du eine bestimmte Palette möchtest, öffne ein GitHub Issue mit Use Case und Palette. Mitgelieferte Designs werden in src-app/src/theme/builtin.rs abgestimmt und mit jeder Release ausgeliefert.