⚡ @ignix/forge – Gestor de Boilerplates desde Git

@ignix/forge es una herramienta de línea de comandos para gestionar boilerplates desde repositorios Git. Agregá tus templates favoritos localmente y creá proyectos nuevos en segundos.

🧰 Construido con

• Node.js + npm
• commander – Manejo de comandos y opciones
• inquirer – Preguntas interactivas
• fs-extra – Operaciones con archivos
• simple-git – Operaciones Git

📦 Instalación local

# Clonar el repositorio
git clone [email protected]:JohnyYen/Ignis-Forge.git
cd Ignis-Forge

# Instalar dependencias
npm install

# Enlazar globalmente
npm link

# Usar el CLI
ignix --help

🚀 Comandos

ignix add

Agrega un boilerplate desde un repositorio Git.

ignix add -n <nombre> -u <url-git> -d <descripcion>

| Flag | Descripción | |------|-------------| | -n, --name | Nombre del boilerplate | | -u, --url | URL del repositorio Git | | -d, --description | Descripción | | -j, --json | Salida en JSON (para agentes) |

Ejemplo:

ignix add -n react-vite -u [email protected]:user/react-boilerplate.git -d "React con Vite"

ignix list

Lista los boilerplates disponibles.

ignix list [--json]

Ejemplo:

ignix list
# 📦 BOILERPLATES DISPONIBLES
# ┌────────────────────────────────────────────────────
# │  • react-vite        React con Vite
# └────────────────────────────────────────────────────

ignix create

Crea un proyecto desde un boilerplate.

ignix create -b <boilerplate> -n <nombre-proyecto> [-p <ruta>]

| Flag | Descripción | |------|-------------| | -b, --boilerplate | Nombre del boilerplate | | -n, --name | Nombre del proyecto | | -p, --path | Ruta donde crear el proyecto | | -j, --json | Salida en JSON |

Ejemplo:

ignix create -b react-vite -n mi-app

ignix update

Actualiza un boilerplate (git pull) o su descripción.

ignix update -n <nombre> [--pull] [-d <descripcion>]

| Flag | Descripción | |------|-------------| | -n, --name | Nombre del boilerplate | | -p, --pull | Ejecutar git pull | | -d, --description | Nueva descripción | | -j, --json | Salida en JSON |

Ejemplo:

ignix update -n react-vite --pull

ignix remove

Elimina un boilerplate.

ignix remove -n <nombre>

| Flag | Descripción | |------|-------------| | -n, --name | Nombre del boilerplate | | -j, --json | Salida en JSON |

Ejemplo:

ignix remove -n react-vite

🤖 Para Agentes

Todos los comandos soportan --json para que agentes como Claude Code, OpenCode, o cualquier bot puedan parsear la salida:

ignix list --json
# [{"name":"react-vite","repo":"...","localPath":"./boilerplates/react-vite"}]

ignix create -b react-vite -n mi-app --json
# {"success":true,"name":"mi-app","boilerplate":"react-vite","path":"./mi-app"}

📁 Estructura

ignix-forge/
├── bin/
│   └── ignix.js              # Entry point
├── commands/
│   ├── add.js                # Add boilerplate
│   ├── list.js               # List boilerplates
│   ├── create.js             # Create project
│   ├── update.js            # Update boilerplate
│   └── remove.js             # Remove boilerplate
├── config/
│   └── boilerplates.json     # Boilerplates registry
├── utils/
│   └── helper.js            # Helper functions
└── package.json

Directorio de trabajo

• Boilerplates locales: ./boilerplates/{nombre}
• Proyectos creados: ./{nombre-proyecto}

🛠️ Características

• ✅ Agregar boilerplates desde cualquier repo Git
• ✅ Copiar boilerplates a nuevos proyectos
• ✅ Actualizar boilerplates con git pull
• ✅ Interfaz JSON para agentes
• ✅ Soporta SSH y HTTPS

📌 Contribuir

¿Querés mejorar Ignix? ¡太好了!

• Creá nuevos comandos
• Agregá features
• Reportá errores

🎉 ¡Listo!

# Agregá tu primer boilerplate
ignix add -n mi-template -u [email protected]:user/repo.git -d "Mi boilerplate"

# Listá lo que tenés
ignix list

# Creá un proyecto
ignix create -n mi-app -b mi-template

¡Arrancá a construir! 🔥