Koko Koala Logo
Koko
0
Avanzado

Guía de Contribución

Desarrollo Open Source

Koko CLI es un proyecto 100% de código abierto bajo la licencia MIT. Agradecemos contribuciones en forma de nuevas plantillas, mejoras en el motor en Go, corrección de errores o sugerencias en la documentación.

Configuración del Entorno de Desarrollo Local

Pasos para clonar, compilar y probar Koko CLI en tu máquina local:

1. Clonar el Repositorio

Clona el repositorio oficial de GitHub e ingresa al directorio:

Terminal
git clone https://github.com/BlasVernazza06/koko-cli.git cd koko-cli

2. Ejecutar y Compilar en Go

Requiere Go 1.21+. Puedes ejecutar el CLI directamente desde el código fuente o compilar el binario:

Terminal
# Ejecutar directamente go run main.go init # Compilar binario local go build -o koko main.go

3. Ejecutar la Suite de Pruebas

Ejecuta las pruebas unitarias y de compatibilidad para verificar que no haya regresiones:

Terminal
go test ./... -v

Estructura Interna del Código en Go

✓ `cmd/`: Comandos de Cobra CLI (`init.go`, `version.go`, `root.go`), máquina de estados TUI (`tui.go`) y vistas de Lipgloss (`cmd/views/`).
✓ `internal/compatibility/`: Motor de validación cruzada y evaluación de reglas lógicas.
✓ `internal/config/`: Generador y serializador del manifiesto `koko.config.json`.
✓ `internal/scaffold/`: Motor de scaffolding, renderizadores de plantillas y generador de Virtual File System (`vfs`).
✓ `internal/catalog/`: Catálogo maestro de versiones de dependencias de npm y librerías externas.
← Anterior Solución de Problemas Avanzado Siguiente → Preguntas Frecuentes Preguntas Frecuentes