Nomenclatura

Plantilla de ejemplo. Adapta estas convenciones a tu stack.

Nombrar bien es de las decisiones más frecuentes y de mayor impacto en la mantenibilidad. Estas son las convenciones del equipo.

Variables y funciones

Elemento	Convención	Ejemplo
Variables / funciones	`camelCase`	`obtenerUsuario`
Componentes React	`PascalCase`	`TarjetaUsuario`
Constantes globales	`UPPER_SNAKE`	`MAX_REINTENTOS`
Tipos / interfaces	`PascalCase`	`EstadoPago`
Booleanos	prefijo `is/has/can`	`isActivo`, `hasError`

Archivos y carpetas

Componentes: PascalCase.tsx → TarjetaUsuario.tsx
Utilidades / hooks: camelCase.ts → useUsuario.ts, formatearFecha.ts
Carpetas: kebab-case → pagos-recurrentes/

Ramas de Git

Usa el formato tipo/descripcion-corta:


feat/checkout-pro
fix/calculo-impuestos
docs/estandares-nomenclatura
chore/actualizar-dependencias

Mantén la coherencia con el idioma del proyecto. Si el dominio del negocio está en español, nombrar conceptos de negocio en español reduce la fricción mental.