🪄 v0.0.0 Latest

Branchizen

Generador interactivo y configurable de nombres de ramas Git

Ideal para equipos que siguen convenciones como:
feature/FE_1234_fix_ui_bug_jdoe

0+ descargas

Licencia MIT

Node.js v14+

¿Por qué Branchizen?

Interactivo

Flujo paso a paso que te guía para crear nombres de ramas consistentes sin memorizar convenciones.

Configurable

Personaliza completamente el orden de campos y preguntas a través del archivo .branchizenrc.json.

Consistente

Garantiza que todo el equipo siga las mismas convenciones de nomenclatura para las ramas.

Instalación y Uso

Instalación Global

$ npm install -g branchizen

Configuración Inicial (Opcional)

$ npx branchizen config


    ______                      _     _               
    | ___ \                    | |   (_)              
    | |_/ /_ __ __ _ _ __   ___| |__  _ _______ _ __  
    | ___ \ '__/ _` | '_ \ / __| '_ \| |_  / _ \ '_ \ 
    | |_/ / | | (_| | | | | (__| | | | |/ /  __/ | | |
    \____/|_|  \__,_|_| |_|\___|_| |_|_/___\___|_| |_|

		:: Branchizen :: v0.0.0
		by Anderson Castaño

		        
? Desea cambiar la configuración? (Y/n) y

❯ compact-dev - Enfocado en ramas cortas para desarrollo, sin demasiados metadatos...
  detailed-tracking - Pensado para flujos donde se requiere trazabilidad completa d...
  release-heavy - Ramas orientadas a releases, incluye versión y fecha de desplieg...
  ticket-centric - Ramas centradas en el identificador del ticket (ideal para integ...
  squad-structured - Ideal para equipos grandes: incluye célula, propósito, autor...

  ✅ Configuración guardada en compact-dev

  ✅ Puedes hacer cambios a tu gusto en el archivo ./.branchizenrc.json

Crear Nueva Rama

$ npx branchizen

✔ ¿Qué tipo de rama quieres crear? › feature

✔ Descripción (en snake_case): › add_login_screen

✔ Tu nombre de usuario: › jdoe

✅ Nombre de rama sugerido:
feature/add_login_screen_jdoe

✔ ¿Deseas crear esta rama con Git? › (Y/n)

Configuración Personalizada

.branchizenrc.json

{
  "description": "Enfocado en ramas cortas para desarrollo, sin demasiados metadatos.",
  "order": [
    "description",
    "user",
    "prefix"
  ],
  "questions": {
    "description": "Describe brevemente la tarea o funcionalidad (usa snake_case):",
    "user": "Ingresa tu identificador o nombre de usuario (ej: jdoe):",
    "prefix": "Prefijo del módulo, componente o área (ej: FE, BE, API):"
  },
  "pattern": "feature/[prefix]_[description]_[user]",
  "standard-branch-name": "compact-dev"
}

Personaliza completamente el flujo agregando nuevos campos al array order y definiendo sus preguntas en questions. También puedes personalizar el patrón final de la rama con el campo pattern.