v3.0.6 - Now with zero dependencies
🍋
CITRUSVER
Fresh squeezed version management
Beautiful, interactive version bumping for Node.js projects with optional git workflows
$ curl -fsSL https://citrusver.jakerains.com/install.sh | bash
$ npx citrusver patch
0
Dependencies
5
Version Types
100%
Pure Node.js
Everything you need for version management
CitrusVer provides a simple, beautiful, and powerful way to manage your project versions
Core
Zero Dependencies
Pure Node.js implementation with no external dependencies. Fast, lightweight, and reliable.
UX
Beautiful CLI
Gorgeous ASCII art, colorful output, and an intuitive interface that makes version management a pleasure.
v3.0
Flag-Based Workflow
Simple by default (version-only), with optional --commit, --tag, --push, and --full flags for git operations.
Git
Smart Git Integration
Optional git commit, tagging, and push with interactive commit messages. Only stages package files, not all changes.
SemVer
Multiple Version Types
Support for patch, minor, major, alpha, beta, and custom prerelease versions with semantic versioning.
Advanced
Safe & Configurable
Hooks for pre/post version scripts, customizable commit templates, and dry-run mode to preview changes.
Choose your workflow
Simple (v3.0 Default)
Just update the version
$ citrusver patch
# Updates package.json only
With Git Commit
Version + commit
$ citrusver patch --commit
# Prompts for commit message
With Git Tag
Version + commit + tag
$ citrusver minor --tag
# Creates annotated git tag
Full Workflow
Version + commit + tag + push
$ citrusver major --full
# Complete release workflow
See it in action
Beautiful, interactive version bumping with colorful terminal output
terminal
🐛
patch
1.0.0 → 1.0.1
✨
minor
1.0.0 → 1.1.0
💥
major
1.0.0 → 2.0.0
🔬
alpha
1.0.0-alpha.0
🚀
beta
1.0.0-beta.0
Documentation
Everything you need to get started with CitrusVer
Installation
Choose your preferred installation method
Compiled Binary (Recommended)
curl -fsSL https://citrusver.jakerains.com/install.sh | bash
NPM (No installation needed)
npx citrusver patch
Global Install
npm install -g citrusver
Basic Usage
Version bumping made simple
# Simple version bump (v3.0 default)
citrusver patch
# Updates package.json only
# With git commit
citrusver minor --commit
# Prompts for commit message
# Full workflow (commit + tag + push)
citrusver major --full
# Complete release workflow