100% Free Forever
AI-Powered Learning
Industry Expert Content
Certificates & Badges
Learn At Your Own Pace

Semantic Versioning Cheat Sheet

Semantic Versioning Cheat Sheet

The MAJOR.MINOR.PATCH semantic versioning specification for communicating compatibility in software releases.

1 PageBeginnerFeb 12, 2026

Version Format

The three-part core version number and what changes to each part signal.

  • MAJOR- Incremented for incompatible/breaking API changes, e.g. 1.x.x to 2.0.0
  • MINOR- Incremented for backward-compatible new functionality, e.g. 1.2.x to 1.3.0
  • PATCH- Incremented for backward-compatible bug fixes, e.g. 1.2.3 to 1.2.4
  • Initial development- 0.y.z means anything may change at any time; the public API should not be considered stable

Version Examples

Reading real version strings against the spec.

text
1.0.0        # First stable public release1.1.0        # Added new backward-compatible feature1.1.1        # Bug fix, no new features2.0.0        # Breaking change, e.g. removed/renamed an API1.0.0-alpha  # Pre-release, lower precedence than 1.0.01.0.0+20260708  # Build metadata, ignored when comparing precedence

npm/semver Range Operators

Common range syntax used in package.json dependencies.

json
{  "dependencies": {    "lodash": "^4.17.21",       "express": "~4.18.0",       "react": "18.2.0",          "typescript": ">=5.0.0 <6.0.0"  }}

Range Operator Meaning

What each caret/tilde operator actually allows.

  • ^ (caret)- Allows changes that do not modify the leftmost non-zero digit, e.g. ^4.17.21 allows 4.x.x but not 5.0.0
  • ~ (tilde)- Allows patch-level changes only, e.g. ~4.18.0 allows 4.18.x but not 4.19.0
  • Exact pin- No operator means only that exact version is accepted
  • Pre-release precedence- 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-beta < 1.0.0

Pre-release Precedence Comparison

How SemVer orders pre-release identifiers when comparing two versions (spec §11).

text
# Precedence is determined by comparing dot-separated identifiers# left to right:#   - numeric identifiers compare numerically#   - alphanumeric identifiers compare lexically (ASCII)#   - numeric identifiers always have LOWER precedence than#     alphanumeric identifiers of the same position#   - a larger set of fields has higher precedence than a smaller#     set, if all preceding identifiers are equal1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-alpha.beta  < 1.0.0-beta < 1.0.0-beta.2 < 1.0.0-beta.11  < 1.0.0-rc.1 < 1.0.0# Build metadata (+...) is ALWAYS ignored for precedence:1.0.0+build.1 == 1.0.0+build.2   # equal precedence

Driving SemVer from Conventional Commits

Machine-derive the next version bump from commit message prefixes instead of a human deciding.

bash
# Conventional Commits prefixes map to a bump level:#   fix: ...          -> PATCH#   feat: ...         -> MINOR#   feat!: ...  or a   -> MAJOR#   'BREAKING CHANGE:' footergit log --oneline v1.4.2..HEAD# fix(auth): handle expired refresh token# feat(api): add cursor-based pagination# feat(api)!: remove deprecated /v1/users endpoint# semantic-release / release-please inspect these and compute:npx semantic-release --dry-run# -> Next release version: 2.0.0 (MAJOR, due to feat!)

Range Overlap & Peer Dependency Conflicts

Why 'it satisfies semver' doesn't guarantee a single install can resolve.

json
{  "dependencies": {    "react": "^18.2.0"  },  "peerDependencies": {    "react": ">=16.8.0 <19.0.0"  }}// npm/yarn must find ONE version of react satisfying every// constraint in the graph simultaneously. Two packages each// pinning incompatible exact versions (react: 17.0.0 vs// react: 18.2.0 with no operator) cannot both be satisfied// with a single copy -> npm ERESOLVE, or duplicate installs// in node_modules (allowed for non-singleton packages, not// for things like React that break with duplicates)

Spec Edge Cases Worth Knowing

Rules from the formal SemVer 2.0.0 spec that are easy to get wrong.

  • 0.y.z is exempt from MAJOR rules- Anything can break between 0.1.0 and 0.2.0; only the move from 0.x to 1.0.0 signals API stability
  • Public API must be declared- SemVer requires you define what counts as your public API (spec §1) — CLI flags, HTTP response shape, and exported types all count if you claim them
  • Version MUST NOT be reused- Once 1.2.3 is released, that exact version+content is immutable forever, even if yanked from a registry
  • Patch bump is mandatory for bug fixes- A backward-compatible bug fix without a PATCH bump violates the spec, since consumers pin ranges expecting fixes to arrive that way
  • Build metadata is not part of precedence- 1.0.0+exp.sha.5114f85 and 1.0.0+build.789 have identical precedence to plain 1.0.0, so tools should not sort by it
  • Major version zero has no stability guarantee- Libraries at 0.x can and do break MINOR-to-MINOR; treat 0.x dependencies as pinned exact versions, not ranged

Versioning Multiple Packages (Monorepos)

How SemVer is applied when one repo ships many independently-consumed packages.

  • Independent versioning- Each package gets its own version bumped only when it changes (e.g. Lerna 'independent' mode, Changesets default)
  • Fixed/locked versioning- All packages in the repo share one version number and bump together, simplifying compatibility claims at the cost of noisy releases
  • Changesets workflow- Contributors add a markdown changeset describing impact (patch/minor/major) per PR; a release tool aggregates them into version bumps and changelogs
  • Cross-package peer ranges- Internal packages typically declare workspace:^ or workspace:* so the monorepo tool rewrites them to real semver ranges only at publish time
Pro Tip

A breaking change is defined by your public API contract, not your intent — removing a field from a JSON response or changing default behavior counts as MAJOR even if you consider it 'just a fix', because it can break consumers silently.

Was this cheat sheet helpful?

Explore Topics

#SemanticVersioning#SemanticVersioningCheatSheet#DevOps#Beginner#VersionFormat#VersionExamples#Npm#Semver#CheatSheet#SkillVeris

Frequently Asked Questions

21 categories · pick one to explore

Does SkillVeris have a tech blog, and what does it cover?
Yes, the SkillVeris blog has over 500 articles covering AI and machine learning, programming, web development, DevOps, cloud, security, databases and career guidance. Articles are practical and answer-first, and many use the Learn Through Hobbies approach, teaching technical concepts through cricket, music, gaming or cooking analogies. Everything is free to read.
What is the SkillVeris tech glossary and how big is it?
The SkillVeris glossary is a free reference of roughly 2,000-plus technology terms, each with a clear plain-language definition. It spans AI, programming, web, DevOps, cloud, security and database vocabulary, so whenever a lesson, article or job description uses jargon you do not recognise, the glossary gives you a fast, reliable answer.
Are the developer cheat sheets on SkillVeris free to download?
The cheat sheets are completely free to use, like everything else on SkillVeris. Each sheet condenses a language or tool into its essential syntax, commands and patterns for quick reference while coding. They are designed for rapid lookup during real work, complementing the deeper explanations found in study notes and courses.
Which programming references and cheat sheets are available?
Cheat sheets cover the platform's main domains, including programming languages, AI and ML tooling, web development, DevOps, cloud, security and databases, matching the topics of the 37 live courses. Each sheet lists related reading links and hashtags, so you can jump from a quick reference into fuller study notes or blog articles.
How do I find the meaning of a technical term quickly?
Search the SkillVeris glossary, which holds around 2,000-plus terms with concise, plain-language definitions. Each entry gets to the point in its first sentence, then links to related reading like blog posts or study notes for deeper context. It is faster and more consistent than sifting through scattered search results.
Is the SkillVeris blog good for beginners learning to code?
Yes, many blog articles are written specifically for beginners, and the Learn Through Hobbies style makes them unusually approachable: you might learn Python concepts through cricket or understand APIs through cooking. With 500-plus articles across skill levels, beginners can start with fundamentals and keep reading as they advance, entirely free.
Can cheat sheets replace full courses for learning a language?
No, cheat sheets are references, not teaching tools; they assume you already understand the concepts and just need syntax or commands fast. To actually learn a language, take a structured SkillVeris course with its 24–40 lessons and assessments, then keep the cheat sheet beside you while practising in Code Lab.
How often are new blog articles published on SkillVeris?
The blog grows regularly and already exceeds 500 articles, with new posts added as courses launch and technologies evolve. Topics track the platform's catalogue across AI, programming, web development, DevOps, cloud and security, so checking the Blog section periodically surfaces fresh tutorials, explainers and career-focused pieces, all free to read.
Does the glossary cover AI and machine learning terms?
Yes, AI and machine learning vocabulary is a major part of the roughly 2,000-plus term glossary, covering everything from foundational terms to modern concepts around LLMs, RAG and MLOps. Definitions are plain-language and answer-first, which helps when dense AI papers or course lessons throw unfamiliar jargon at you.
Are there cheat sheets for interview preparation?
Cheat sheets work well as interview-day refreshers because they compress syntax, commands and key concepts into scannable references. For dedicated preparation, combine them with the SkillVeris interview questions feature, which includes readiness scoring, plus study notes for depth. Reviewing a relevant cheat sheet just before an interview steadies recall under pressure.
Can I read the tech blog without signing up?
Yes, the blog is freely readable, and SkillVeris never charges for content. All 500-plus articles are open, covering tutorials, concept explainers and career advice. Creating a free account adds value elsewhere on the platform, like course progress tracking and certificates, but reading the blog requires no commitment at all.
How is the SkillVeris glossary different from Wikipedia?
The glossary is purpose-built for learners: definitions are short, plain-language and answer-first, sized for a quick lookup mid-lesson rather than a deep encyclopedic read. Entries also cross-link to related SkillVeris study notes, blog posts and courses, so a definition becomes a doorway into structured learning instead of a dead end.
Do blog articles use the Learn Through Hobbies method?
Many blog articles teach technical topics through hobby analogies, a hallmark of the SkillVeris blog, so you will find articles explaining programming through cricket, machine learning through music, or system design through cooking. The analogy is the teaching device; the article still delivers the real technical concept underneath.
Where can I find quick programming references while coding?
Open the SkillVeris cheat sheets, which are built exactly for that moment: compact, scannable references for syntax, commands and common patterns across languages and tools. Keep the relevant sheet in a browser tab while you work in Code Lab or your own editor, and dip into the glossary for terminology.
Is there a glossary entry for terms I meet in job descriptions?
Very likely yes, with roughly 2,000-plus terms across AI, programming, web, DevOps, cloud, security and databases, the glossary covers most jargon that appears in tech job descriptions. Decoding a listing this way helps you judge role fit honestly and prepares you to discuss those terms in interviews.
Are the blog articles written for the Indian tech audience?
The blog serves Indian learners plus a worldwide audience. Content stays globally relevant while acknowledging realities that matter in India, such as free access being essential for students and freshers, and career guidance that connects naturally to the SkillVeris jobs portal, which aggregates roles across India, UK, USA, Germany and Remote.
Can I suggest a topic for the blog or glossary?
SkillVeris content grows in response to what learners need, so feedback is welcome through the platform's support channels. If a term is missing from the glossary or a topic deserves an article, telling the team helps prioritise it. Meanwhile, the AI Mentor can answer the question immediately, 24/7, at any depth.
Do cheat sheets and glossary entries link to deeper learning?
Yes, every cheat sheet and glossary entry carries related reading links into study notes, blog articles and courses, plus concept hashtags for discovering similar content. This cross-linking means a thirty-second lookup can smoothly become a structured learning session whenever you decide you want more than a quick answer.
What makes SkillVeris programming references trustworthy?
The references are written to strict internal quality standards, kept consistent with the platform's 37 live courses, and never padded with invented statistics or hype. Definitions and cheat sheets are reviewed against the same content contracts that govern courses, and the answer-first style makes any inaccuracy easy to spot and correct.
How do the blog, glossary and cheat sheets fit into my learning routine?
Use them as satellites around your main course: read blog articles for context and motivation, hit the glossary the instant jargon appears, and keep cheat sheets open while coding. Together with study notes, Code Lab and the 24/7 AI Mentor, they turn passive reading into a complete, free learning system.

What Learners Say

Real journeys from the SkillVeris community — swipe for more.

SkillVeris taught me Python through Cricket. Now I’m building real projects and feeling confident!
Arjun S. · B.Tech Student
The best platform for hobby-based learning. Concepts finally stick.
Priya R. · Data Analyst
I went from zero coding to a portfolio of projects — all by learning through my love for gaming. Landed my first internship!
Kabir M. · CS Undergraduate
Trending Topics50 popular tags — tap to explore
Trending CoursesAll 37 free courses — tap to browse