PHPackages                             lightszentip/laravel-release-changelog-generator - 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 &amp; Helpers](/categories/utility)
4. /
5. lightszentip/laravel-release-changelog-generator

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

lightszentip/laravel-release-changelog-generator
================================================

Package to create releases and changelogs in laravel

1.0.0(8mo ago)915.3k↓15.9%6[1 issues](https://github.com/lightszentip/laravel-release-changelog-generator/issues)[7 PRs](https://github.com/lightszentip/laravel-release-changelog-generator/pulls)MITPHPPHP &gt;=8.3CI passing

Since Dec 22Pushed 1mo agoCompare

[ Source](https://github.com/lightszentip/laravel-release-changelog-generator)[ Packagist](https://packagist.org/packages/lightszentip/laravel-release-changelog-generator)[ Docs](https://github.com/lightszentip/laravel-release-changelog-generator)[ RSS](/packages/lightszentip-laravel-release-changelog-generator/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (14)Versions (19)Used By (0)

Package to create releases and changelogs in Laravel
====================================================

[](#package-to-create-releases-and-changelogs-in-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/17eafc7d029492530f621e4b3b2800cf3b5fc93cf62dfc3bf61876be45d1580a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c69676874737a656e7469702f6c61726176656c2d72656c656173652d6368616e67656c6f672d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/lightszentip/laravel-release-changelog-generator)[![GitHub Tests Action Status](https://camo.githubusercontent.com/5802cdda76a0b849ea4e0da72027c995d4ca02c3add20e1a202aafc6e472086a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6c69676874737a656e7469702f6c61726176656c2d72656c656173652d6368616e67656c6f672d67656e657261746f722f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/lightszentip/laravel-release-changelog-generator/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/1cc0b7d049f823b84aec3efb1db8e7830b09d65fe7d8262af517af091d4f2d93/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6c69676874737a656e7469702f6c61726176656c2d72656c656173652d6368616e67656c6f672d67656e657261746f722f466978253230504850253230636f64652532307374796c652532306973737565733f6c6162656c3d636f64652532307374796c65)](https://github.com/lightszentip/laravel-release-changelog-generator/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/9597d075878d2e73183313f69de0600c0330fd688c8685df4a84c56a7bc19f90/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c69676874737a656e7469702f6c61726176656c2d72656c656173652d6368616e67656c6f672d67656e657261746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/lightszentip/laravel-release-changelog-generator) [![PHP-CS-Fixer](https://github.com/lightszentip/laravel-release-changelog-generator/actions/workflows/quality-check.yml/badge.svg?branch=main)](https://github.com/lightszentip/laravel-release-changelog-generator/actions/workflows/quality-check.yml) [![Update Changelog GIT](https://github.com/lightszentip/laravel-release-changelog-generator/actions/workflows/update-changelog-main.yml/badge.svg)](https://github.com/lightszentip/laravel-release-changelog-generator/actions/workflows/update-changelog-main.yml)

This package adds changelog management over the command line and version release management. You can add new changelog items, and if you release, the changelog is updated with the new version and the version file. Thus, it is easy to manage a customer changelog.

The changelog is a JSON file that can easily be integrated into a controller to present to the end customer.

See [ROADMAP](ROADMAP.md) for new functions.

*HINT*: Please run 'php artisan vendor:publish --tag=resources'

Version Compatibility
---------------------

[](#version-compatibility)

Release Changelog GeneratorPHPLaravel0.1.x&gt;=8.090.2.0&gt;=8.090.2.1&gt;=8.09 / 10 (not tested)0.3.x&gt;=8.19 / 100.4.x&gt;=8.2111.0.x&gt;=8.311, 12Installation
------------

[](#installation)

You can install the package via Composer:

```
composer require lightszentip/laravel-release-changelog-generator
```

Please publish the necessary files with:

```
php artisan vendor:publish --provider="Lightszentip\LaravelReleaseChangelogGenerator\ServiceProvider"
php artisan vendor:publish --tag=resources
```

Usage
-----

[](#usage)

If the command is used without arguments, the command line creates an ask for all necessary arguments.

### Create a new changelog item:

[](#create-a-new-changelog-item)

```
php artisan changelog:add --type="feat" --message="Implement the whole function for magic"
```

You can find the result in resources/.changes/changelog.json

### Release the changelog

[](#release-the-changelog)

```
php artisan changelog:release --releasename="My First Release" --type=patch
```

This updates the version.yml to the next patch version and add in the changelog.json a new release with all current changelog items.

### Update CHANGELOG.md file:

[](#update-changelogmd-file)

This will update the CHANGELOG.md file in the root with your changes.

```
php artisan changelog:generate-md
```

### Get the version in the application

[](#get-the-version-in-the-application)

#### Blade

[](#blade)

```
@releasechangelog
```

To get a special format for the version, you find in the 'releasechangelog.php' in the config dir the item ' version\_formats'. You can add new formats and/or change the existing ones. To use it:

```
@releasechangelog('full')
```

#### Code

[](#code)

```
app('releasechangelog.version')->showVersion($format)
```

### Config

[](#config)

`prerelease` set to false to remove the "rc" part from version

To use another pre-release name as 'rc', change it on version.yml direct.

### Example Result

[](#example-result)

#### version.yml

[](#versionyml)

```
label: v
major: 1
minor: 0
patch: 1
prerelease: rc
prereleasenumber: 0
buildmetadata: null
timestamp:
    date: null
    timestamp: null

```

#### changelog.json

[](#changelogjson)

```
{"unreleased":{"name":"tbd","date":"","release":false},
"1.0.1.rc0":{"name":"My First Release","date":"2022-12-22 23:56:34","release":true,"feat":[{"message":"My first feature"},{"message":"Implement the whole function for magic"}]}}

```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Lightszentip](https://github.com/lightszentip)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance74

Regular maintenance activity

Popularity34

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~109 days

Recently: every ~222 days

Total

10

Last Release

258d ago

Major Versions

0.4.1 → 1.0.02025-09-02

PHP version history (5 changes)0.1.0PHP &gt;=8.0|^8.1

0.3.0PHP &gt;=8.1|^8.2

0.3.5PHP &gt;=8.1|^8.2|^8.3

0.4.0PHP &gt;=8.2|^8.3

1.0.0PHP &gt;=8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/5d722951b53368586c9137845a403cb158950e9a0b325d67f470e34e11177aae?d=identicon)[lightszentip](/maintainers/lightszentip)

---

Top Contributors

[![lightszentip](https://avatars.githubusercontent.com/u/3680505?v=4)](https://github.com/lightszentip "lightszentip (197 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (180 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (177 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (44 commits)")[![robbanl](https://avatars.githubusercontent.com/u/922250?v=4)](https://github.com/robbanl "robbanl (5 commits)")[![iabduul7](https://avatars.githubusercontent.com/u/24309704?v=4)](https://github.com/iabduul7 "iabduul7 (1 commits)")[![xalunda](https://avatars.githubusercontent.com/u/2316221?v=4)](https://github.com/xalunda "xalunda (1 commits)")

---

Tags

artisan-commandchangeloglaravellaravel-changeloglaravel-cilaravel-packagelaravel-releaserelease-clilaravellightszentiplaravel-release-changelog-generator

###  Code Quality

TestsPest

Static AnalysisPsalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/lightszentip-laravel-release-changelog-generator/health.svg)

```
[![Health](https://phpackages.com/badges/lightszentip-laravel-release-changelog-generator/health.svg)](https://phpackages.com/packages/lightszentip-laravel-release-changelog-generator)
```

###  Alternatives

[ycodetech/valet-windows

A more enjoyable local development experience for Windows. A Windows port of the popular Laravel Valet and a fork of cretueusebiu/valet-windows, with new features.

451.6k](/packages/ycodetech-valet-windows)[anilcancakir/laravel-ai-sdk-skills

A skill system for Laravel AI SDK agents. Define reusable AI capabilities with SKILL.md files.

151.1k](/packages/anilcancakir-laravel-ai-sdk-skills)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
