Temas

Paneflow lee el valor "theme" en el nivel superior de paneflow.json. Los temas incluidos actualmente son One Dark y PaneFlow Light. Si omites la clave, la defines como null o la restableces desde Settings, Paneflow usa el tema predeterminado One Dark.

TL;DR. Usa Settings -> Themes en la interfaz, o define "theme": "One Dark" / "theme": "PaneFlow Light" en paneflow.json. Los cambios de tema se recargan en caliente al guardar, sin reiniciar la app.

¿Cómo cambio el tema activo?

Abre Settings -> Themes y elige uno de los tres segmentos:

System no se guarda hoy como un modo persistente que siga al OS. Después de elegirlo, Paneflow escribe uno de los nombres de tema incluidos arriba.

También puedes editar paneflow.json directamente:

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

El archivo de configuración está en:

El schema lista las grafías canónicas. En runtime, la búsqueda del nombre no distingue mayúsculas, pero usar los nombres canónicos mantiene limpios el autocompletado del editor y los diffs. Los nombres desconocidos caen a One Dark y emiten una advertencia en el log la próxima vez que se parsea el archivo. El conjunto completo de claves reconocidas vive en el schema de configuración.

¿Qué temas incluye Paneflow hoy?

Estable en las builds actuales.

Un tema de Paneflow define 36 ranuras de color de terminal: una paleta ANSI de 24 colores (8 tonos x 3 intensidades: normal, bright, dim), 5 colores base de fondo/primer plano, cursor, selección con primer plano derivado, scrollbar, texto de enlace y 2 colores de barra de título. Paneflow también mantiene una paleta de sintaxis separada para la superficie Diff.

El primer plano de selección no se ajusta a mano. Paneflow lo recalcula al cargar el tema hasta superar APCA Lc >= 45 contra el fondo de selección, para que el texto seleccionado siga siendo legible.

¿Qué afecta un tema?

Los temas afectan más que los colores ANSI del terminal:

• fondo, primer plano, cursor, selección, scrollbar, enlaces y paleta ANSI del terminal;
• la paleta del chrome de la app derivada del tema activo;
• paneles Markdown y tablas;
• colores de sintaxis de Diff y Review;
• barra de título y materiales nativos en plataformas compatibles.

Dos ajustes relacionados están separados del nombre del tema:

• terminal.cursor_color solo sobrescribe el cursor del terminal. null usa el color de cursor del tema activo.
• commands[].workspace.color es un color de template workspace, no un accent del tema.

¿Cómo funciona la recarga en caliente?

Cuando guardas paneflow.json, Paneflow vuelve a resolver el tema activo al vuelo. No necesitas reiniciar ni recargar la ventana.

Dos mecanismos impulsan la recarga:

• Ruta basada en eventos. Un watcher notify vigila el directorio de configuración y aplica un debounce de 300 ms a los eventos de archivo.
• Fallback por sondeo. Si el watcher del OS no puede arrancar, Paneflow vuelve a un sondeo mtime de 500 ms.

Verás la nueva paleta en el siguiente frame de render tras dispararse el watcher o el fallback. Si la recarga falla en silencio en tu máquina, la página de troubleshooting repasa las causas comunes.

Las claves de tema y tipografía se recargan en caliente desde paneflow.json. La clave window_decorations se lee una sola vez al inicio, así que cambiarla todavía requiere reiniciar Paneflow.

¿Cómo creo un tema personalizado?

Los archivos de tema personalizados del usuario aún no están soportados. Paneflow no carga theme.json, y hoy no existe un formato de paleta personalizada en paneflow.json.

Si quieres una paleta concreta, abre un issue de GitHub con el caso de uso y la paleta. Los temas incluidos se ajustan en src-app/src/theme/builtin.rs y se entregan con cada release.