Paneflow lee un único archivo JSON al arranque: paneflow.json. Cada
clave es opcional y tiene un valor predeterminado sensato, así que
un {} vacío es una configuración válida. La referencia completa,
incluyendo tipos, valores predeterminados, momento de aplicación y
notas de runtime,
vive en la página del esquema.
TL;DR. Un solo archivo: paneflow.json. Cada clave es opcional, {} es válido, las claves desconocidas se ignoran. Fija la línea $schema de abajo para autocompletar en tu editor.
¿Dónde está paneflow.json?
| SO | Ruta |
|---|---|
| Linux y macOS | ~/.paneflow/paneflow.json |
| Windows | %USERPROFILE%\.paneflow\paneflow.json |
PANEFLOW_HOME mueve todo el directorio (configuración, sesión, worktrees,
caché, binarios auxiliares). La configuración encontrada en las ubicaciones
anteriores (~/.config/paneflow, ~/Library/Application Support/paneflow,
%APPDATA%\paneflow) se copia en ~/.paneflow en el primer arranque.
Si el archivo no existe en el primer arranque, Paneflow arranca con todos los valores predeterminados. Crea el archivo en la ruta de arriba para empezar a personalizar.
Autocompletado del editor con JSON Schema
Fija una referencia $schema para obtener autocompletado instantáneo
y verificación de tipos en VS Code, JetBrains, Zed, Helix o cualquier
editor con un servidor de lenguaje JSON Schema:
{
"$schema": "https://github.com/arthjean/paneflow/raw/main/schemas/paneflow.schema.json",
"theme": "One Dark"
}El esquema se publica con cada release y rastrea el conjunto exacto de claves que acepta el build en ejecución.
¿Cómo maneja Paneflow las claves desconocidas?
Paneflow es permisivo en tiempo de ejecución: las claves de nivel superior desconocidas se ignoran silenciosamente, y las claves faltantes se resuelven a sus valores predeterminados. Esto mantiene tu configuración compatible hacia adelante entre releases - meter una clave de un build más nuevo nunca rompe un binario de Paneflow más antiguo.
El JSON Schema además rechaza claves desconocidas en tiempo de
edición (additionalProperties: false), así que tu editor señala
errores tipográficos antes de que guardes. El runtime se mantiene
permisivo a propósito.