Thèmes

Choisissez une palette pour les terminaux et l'interface de Paneflow, puis un mode clair, sombre ou adapté au système. Paneflow propose cinq palettes : Paneflow, Vercel, Claude, Cursor et Tailwind. Chacune existe en version claire et sombre. Le thème par défaut est Paneflow Dark.

Les changements s'appliquent sans redémarrer Paneflow, depuis les paramètres comme depuis le fichier paneflow.json.

Choisir un thème

1. Ouvrez Appearance dans les paramètres de Paneflow.
2. Sélectionnez Light, Dark ou System.
3. Choisissez une palette dans Preset.

Le mode System reste sélectionné après la fermeture et la réouverture de Paneflow. Lorsque l'apparence du système change, Paneflow passe d'une version à l'autre en conservant la même palette.

Pour revenir à Paneflow Dark, sélectionnez Reset to default dans la section Theme.

Palettes incluses

Utilisez ces noms exacts dans le champ theme de paneflow.json. Les noms des palettes sont identiques dans toutes les langues.

Les noms ne sont pas sensibles à la casse. Les anciennes configurations restent valides : One Dark correspond à Paneflow Dark, et PaneFlow Light à Paneflow Light. Les anciens noms Vercel, Claude et Cursor correspondent à leurs versions sombres.

Définir un thème dans paneflow.json

Définissez theme avec un nom du tableau et theme_mode avec le mode correspondant. Par exemple, pour utiliser la palette claire de Claude :

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

Pour suivre plutôt l'apparence du système, définissez theme_mode sur "system". Paneflow conserve la palette choisie par theme et utilise sa version claire ou sombre selon le système.

Le fichier de configuration se trouve par défaut à ces emplacements :

Si vous avez défini PANEFLOW_HOME, modifiez le fichier dans ce dossier. Consultez la référence de configuration pour l'ensemble des réglages.

Si theme_mode est absent ou vaut null, Paneflow déduit le mode clair ou sombre du nom du thème. Pour rétablir la configuration par défaut, supprimez theme et theme_mode, ou définissez les deux sur null.

Ce que le thème modifie

• L'arrière-plan, le texte, le curseur, la sélection, la barre de défilement, les liens et les couleurs ANSI du terminal.
• Les arrière-plans, les bordures et le texte de l'interface.
• Les panneaux Markdown et leurs tableaux.
• Les couleurs de syntaxe dans Changes et Files.

Certains réglages d'apparence sont indépendants :

• terminal.cursor_color remplace la couleur du curseur du terminal. Définissez cette clé sur null pour utiliser celle du thème.
• Interface style contrôle les matériaux et la transparence de la fenêtre. Consultez les paramètres d'apparence.
• commands[].workspace.color définit la couleur d'un modèle d'espace de travail.

Si le thème ne change pas

Après avoir modifié paneflow.json, enregistrez le fichier. Si le thème précédent reste affiché, vérifiez que vous avez modifié le fichier de configuration actif et que son JSON est valide. Lors du rechargement, Paneflow conserve la dernière configuration valide si le nouveau fichier contient une erreur JSON.

Si Paneflow Dark s'affiche à la place de la palette souhaitée, vérifiez le nom du thème dans le tableau ci-dessus. Un nom inconnu déclenche le retour à Paneflow Dark et un avertissement dans les journaux.

Pour aller plus loin, consultez le guide de dépannage de la configuration. La modification de window_decorations nécessite un redémarrage, contrairement aux changements de thème.

Palettes personnalisées

Paneflow prend en charge uniquement les palettes incluses. Il ne charge ni theme.json ni de palette personnalisée depuis paneflow.json.

Pour proposer une autre palette, ouvrez une demande de thème sur GitHub en précisant les couleurs et leur usage. Pour contribuer un thème inclus dans l'application, partez de src-app/src/theme/builtin.rs dans le dépôt de l'application de bureau.