envfix
Herramienta de diagnóstico de configuración de entorno para Node.js, sin dependencias, que compara archivos de entorno y completa automáticamente las entradas que faltan.
Acerca de envfix
envfix es una herramienta de diagnóstico de configuración de entorno para proyectos de Node.js, sin dependencias y fácil de integrar en CI. Compara .env y .env.example elemento por elemento para detectar rápidamente variables ausentes o vacías, identifica declaraciones duplicadas o con formato incorrecto y comprueba además si .env está correctamente excluido mediante gitignore. Al reparar, las claves que faltan se añaden al final de .env sin modificar las líneas y valores existentes; también puede generar o sincronizar .env.example sin exponer secretos. El comando doctor evalúa además si la configuración del entorno es saludable, coherente y segura; en CI finaliza con el código de salida 1 cuando hay variables ausentes o vacías, lo que ayuda a los equipos a detectar la deriva de configuración antes de que llegue a producción.
Ideal para
Mejores casos de uso
Revisar el .env local tras clonar un proyecto y completar automáticamente las variables que faltan
Interceptar en CI las variables ausentes o vacías para evitar que la deriva de configuración llegue a producción
Generar y sincronizar .env.example para equipos o proyectos de código abierto sin exponer secretos reales
Usar el comando doctor para una revisión completa de la salud, coherencia y seguridad de la configuración de entorno de un proyecto
Funciones
Comprobación por comparación de configuración
Compara .env y .env.example elemento por elemento, detecta variables ausentes o vacías e identifica declaraciones duplicadas o con formato incorrecto.
Diagnóstico profundo con doctor
Responde a preguntas más amplias que la comprobación básica: ¿la configuración de entorno del proyecto es saludable, coherente y segura?
Reparación segura por adición
Las claves que faltan se añaden a .env; las líneas y valores existentes nunca se modifican.
Seguridad de secretos y del repositorio
Genera o sincroniza .env.example sin exponer secretos y comprueba si .env está correctamente excluido mediante gitignore.
Ventajas
- Sin dependencias: instalación ligera y fácil de usar en CI
- Reparaciones por adición que no modifican las líneas y valores existentes
- Por defecto no imprime los valores de las variables de entorno en la terminal, JSON ni anotaciones de CI, lo que reduce el riesgo de fugas
- Termina con el código de salida 1 cuando faltan variables o están vacías, lo que permite a los pipelines detenerse de inmediato