What is Semantic Versioning (SemVer)?

Semantic Versioning is a versioning scheme in the format MAJOR.MINOR.PATCH. Increment MAJOR for breaking changes, MINOR for new backward-compatible features, and PATCH for backward-compatible bug fixes. The full spec is at semver.org.

When should I increment the major version?

Increment MAJOR (e.g. 1.4.2 → 2.0.0) when you make incompatible API changes — removed endpoints, renamed methods, changed return types, or database migrations that break existing integrations. MINOR and PATCH reset to 0.

What does the pre-release identifier do?

A pre-release identifier (e.g. -alpha.1, -beta.2, -rc.1) marks the version as unstable and lower precedence than the release version. For example, 2.0.0-rc.1 < 2.0.0. Use it to signal work-in-progress releases to early adopters.

Should I use v prefix in git tags?

The SemVer spec itself does not include the 'v' prefix, but it is a widely adopted convention in git (e.g. git tag v2.0.0). GitHub, npm, and most CI/CD tools recognize the 'v' prefix and display it correctly in release pages.

Semantic Versioning (SemVer) Calculator & Release Planner

Versión Actual

Ingresa tu etiqueta de lanzamiento actual. Debe seguir el formato MAJOR.MINOR.PATCH. MAJOR.MINOR.PATCH

⚠ Por favor ingresa una versión válida como 1.0.0 o 2.14.3 1.0.0 2.14.3

¿Qué cambió en esta versión?

Selecciona todo lo que aplique - gana la regla de mayor prioridad.

💥

Cambios Incompatibles

MAJOR +1

Cambios incompatibles en la API, endpoints eliminados o comportamiento que rompe las integraciones existentes.

1.4.2 → 2.0.0 Endpoint de autenticación eliminado Migración del esquema de BD

✨

Nuevas Funciones / Mejoras

MINOR +1

Nueva funcionalidad compatible con versiones anteriores, nuevos endpoints de API o mejoras significativas de UX.

1.4.2 → 1.5.0 Modo oscuro agregado Nuevo endpoint /export

🐛

Corrección de Errores / Parches

PATCH +1

Correcciones de errores compatibles con versiones anteriores, parches de seguridad o mejoras de rendimiento sin nueva funcionalidad.

1.4.2 → 1.4.3 Corregir fallo de inicio de sesión Parche XSS

Reglas de Prioridad SemVer

¿Cambio incompatible presente? → Incrementar MAJOR, restablecer MINOR y PATCH a 0.

¿Nueva función (sin incompatibilidad)? → Incrementar MINOR, restablecer PATCH a 0.

¿Solo correcciones de errores? → Incrementar solo PATCH.

¿Nada seleccionado? → Versión sin cambios.

Próxima Versión Recomendada

v 1.0.0

Desglose de Versión

MAJOR

MINOR

PATCH

💡 Selecciona tipos de cambio a la izquierda para calcular tu próxima versión.

Comandos Git

$ git tag v1.0.0

$ git push origin v1.0.0

Vista Previa del Título de Lanzamiento de GitHub

🚀 Lanzamiento v1.0.0

¿Versión confirmada? ¡Publícala! 🚀

Publica instantáneamente tus notas de lanzamiento v1.0.0 a tus usuarios y activa las notificaciones de la aplicación con Bellotify.

Publica Tu Changelog Ahora

Calculadora SemVer & Planificador de Lanzamientos

Reglas de Prioridad SemVer

Calculadora SemVer &
Planificador de Lanzamientos