PHPackages voral/laravel-version-increment - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. voral/laravel-version-increment ActiveLibrary[Utility & Helpers](/categories/utility) voral/laravel-version-increment =============================== Laravel Artisan adapter for vs-version-incrementor — automated versioning and changelog generation based on Git commits. 3.0.0(4mo ago)08MITPHPPHP >=8.2CI passing Since Dec 25Pushed 4mo agoCompare [ Source](https://github.com/Voral/laravel-version-increment)[ Packagist](https://packagist.org/packages/voral/laravel-version-increment)[ Docs](https://github.com/Voral/laravel-version-increment)[ RSS](/packages/voral-laravel-version-increment/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (8)Versions (3)Used By (0) Laravel Adapter for `vs-version-incrementor` ============================================ [](#laravel-adapter-for-vs-version-incrementor) [RU](https://github.com/Voral/laravel-version-increment/blob/master/README.ru.md) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/69ce893c014ebcc8ee3d22b67a5ec425ed813c9b13985fe3a36571ef0713c4cf/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f566f72616c2f6c61726176656c2d76657273696f6e2d696e6372656d656e742f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/Voral/laravel-version-increment/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/4b085700ebc88c7d42688ce28499f6cf4c560cbb3c98576aaff0893d3264cb49/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f566f72616c2f6c61726176656c2d76657273696f6e2d696e6372656d656e742f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/Voral/laravel-version-increment/?branch=master)[![Code Intelligence Status](https://camo.githubusercontent.com/5bee0c04ed12905f04d8cc59d58789b9f5a3c00ae3fb956f1e45547c40448768/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f566f72616c2f6c61726176656c2d76657273696f6e2d696e6372656d656e742f6261646765732f636f64652d696e74656c6c6967656e63652e7376673f623d6d6173746572)](https://scrutinizer-ci.com/code-intelligence) [![PHP Tests](https://github.com/Voral/laravel-version-increment/actions/workflows/php.yml/badge.svg)](https://github.com/Voral/laravel-version-increment/actions/workflows/php.yml/badge.svg) This package provides a **native Artisan command** for [`vs-version-incrementor`](https://github.com/Voral/vs-version-incrementor) — a tool for automated version management and `CHANGELOG.md`generation based on Git commit analysis. Now you can leverage all features of `vs-version-incrementor` directly from the Laravel console — without manually invoking external scripts. --- Installation ------------ [](#installation) Install the package via Composer: ``` composer require voral/laravel-version-increment --dev ``` > The package is auto-registered thanks to Laravel Package Auto-Discovery. --- Usage ----- [](#usage) After installation, the following Artisan commands become available. ### Increment the version: [](#increment-the-version) ``` # Automatically detect the release type (based on Conventional Commits) php artisan vs-version:increment # Explicitly specify the version type php artisan vs-version:increment major php artisan vs-version:increment minor php artisan vs-version:increment patch ``` ### Preview changes that would be included in the next version and the expected new version — without modifying any files: [](#preview-changes-that-would-be-included-in-the-next-version-and-the-expected-new-version--without-modifying-any-files) ``` # Automatically detect the release type php artisan vs-version:debug # Explicitly specify the version type php artisan vs-version:debug major php artisan vs-version:debug minor php artisan vs-version:debug patch ``` ### Update `CHANGELOG.md` and `composer.json` (if configured), but skip creating the final Git commit and tag: [](#update-changelogmd-and-composerjson-if-configured-but-skip-creating-the-final-git-commit-and-tag) ``` # Automatically detect the release type php artisan vs-version:no-commit # Explicitly specify the version type php artisan vs-version:no-commit major php artisan vs-version:no-commit minor php artisan vs-version:no-commit patch ``` ### List all registered commit types and scopes: [](#list-all-registered-commit-types-and-scopes) ``` php artisan vs-version:list ``` --- Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel 11 or 12 - Git available in `PATH` - `voral/version-increment` (installed automatically as a dependency) --- Configuration ------------- [](#configuration) The adapter uses **the same configuration file** as the original CLI tool. Create `.vs-version-increment.php` in your project root to customize: - rules for determining major/minor/patch increments, - `CHANGELOG.md` formatting, - ignoring untracked files, - handling squashed commits, - custom commit types, and more. See the full documentation: [vs-version-incrementor Configuration Guide](https://github.com/Voral/vs-version-incrementor?tab=readme-ov-file#configuration) Implementation Details ---------------------- [](#implementation-details) This package is a **thin wrapper** around the original utility: it invokes `./vendor/bin/vs-version-increment` with the appropriate arguments and flags, ensuring **full behavioral parity** with the standalone CLI tool. --- License ------- [](#license) MIT. See [LICENSE](LICENSE) for details. > **Depends on**: [vs-version-incrementor](https://github.com/Voral/vs-version-incrementor) — automated versioning based on Git history. ### Health Score 37 — LowBetter than 82% of packages Maintenance80 Actively maintained with recent releases Popularity6 Limited adoption so far Community6 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 134d ago Major Versions 0.3.0 → 3.0.02025-12-26 PHP version history (2 changes)0.3.0PHP >=8.1 3.0.0PHP >=8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/ce4dfd67b12e198becd71253723d0c83044cb4689b735f2fd4eee4ac191c41ec?d=identicon)[Voral](/maintainers/Voral) --- Top Contributors [![Voral](https://avatars.githubusercontent.com/u/327165?v=4)](https://github.com/Voral "Voral (28 commits)") --- Tags artisan-commandchangelogchangelog-generatorconventional-commitsgitlaravelphpsemantic-versioningsemverversion-increment ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/voral-laravel-version-increment/health.svg) ``` [![Health](https://phpackages.com/badges/voral-laravel-version-increment/health.svg)](https://phpackages.com/packages/voral-laravel-version-increment) ``` ### Alternatives [barryvdh/laravel-ide-helper Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion. 14.9k123.0M683](/packages/barryvdh-laravel-ide-helper)[orchestra/canvas Code Generators for Laravel Applications and Packages 21017.2M157](/packages/orchestra-canvas)[yajra/laravel-datatables-buttons Laravel DataTables Buttons Plugin. 2629.1M54](/packages/yajra-laravel-datatables-buttons)[elfsundae/laravel-hashid A simple, elegant way to obfuscate your data by generating reversible, non-sequential, URL-safe identifiers. 415246.3k2](/packages/elfsundae-laravel-hashid)[consoletvs/charts The laravel charting package 863.6M25](/packages/consoletvs-charts)[laragear/preload Effortlessly make a Preload script for your Laravel application. 119363.5k](/packages/laragear-preload) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)