neondigital/changelog

A changelog package for Laravel

dev-main 2025-11-10 10:59 UTC

Requires

• laravel/framework: ^v11.45|^12.32
• spatie/laravel-data: ^3.6
• spatie/laravel-markdown: ^2.7
• spatie/yaml-front-matter: ^2.1

Requires (Dev)

• symplify/monorepo-builder: ^12.2

MIT

• Alec Ritson

README

Provide changelog updates to a select list of email addresses to show what has changed in your app.

Installation

composer require neondigital/changelog

Publish the configuration

php artisan vendor:publish 

Usage

Create a changelog entry

Changelog Markdown files live in the changelog directory at the root of your application and should be in named in YYYY_MM_DD_XXXXXXX.

---
title: Minor updates to the system
version: 1.0.3
changes: 
    - 
        type: fix
        title: "Documentation: fix typo and phrasing"
    -
        type: improvement
        title: Add clarity for opt-out telemetry during upgrade
    -
        type: fix
        title: Handle soft deleted purchasable on order lines
    -
        type: addition
        title: We added this thing so it's better
---

## What's Changed
* A new feature was added

Sending update emails

You can send changelog notifications to an array of email addresses:

    Changelog::notifyOnRelease(function () : array {
        return ['[e-mail]', '[e-mail]'];
    });

You can override the published views in views/vendor/changelog.

Publishing a release

To publish a release and send out notifications you just need to call:

php artisan changelog:release

This will create a release manifest with the latest release and send out any emails as defined using the notifiyOnRelease method. The creation of the manifest file ensures you can call this command repeatedly without the worry of sending multiple notifications.