PHPackages mdimannyit/changelog-tracker - 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. mdimannyit/changelog-tracker ActiveLibrary[Utility & Helpers](/categories/utility) mdimannyit/changelog-tracker ============================ AI-Powered Laravel Changelog Tracker v1.3.3(1mo ago)05MITBladePHP ^8.2 Since Apr 11Pushed 1mo agoCompare [ Source](https://github.com/mdimannyit/changelog-tracker)[ Packagist](https://packagist.org/packages/mdimannyit/changelog-tracker)[ RSS](/packages/mdimannyit-changelog-tracker/feed)WikiDiscussions main Synced 1w ago READMEChangelog (5)Dependencies (3)Versions (6)Used By (0) Laravel AI Changelog Tracker ============================ [](#laravel-ai-changelog-tracker) An AI-powered, plug-and-play Laravel package that automates the generation and presentation of system changelogs. It records application events and uses AI (OpenAI by default, with powerful Custom/Fallback support) to generate rich, beautiful Markdown summaries presented in a pre-built Livewire timeline. Repository ---------- [](#repository) Source and issue tracking: [github.com/mdimannyit/changelog-tracker](https://github.com/mdimannyit/changelog-tracker). Published package: [Packagist](https://packagist.org/packages/mdimannyit/changelog-tracker). Features -------- [](#features) - 🤖 **Automated Summaries**: Pipes raw event data into AI to describe changes intelligently using standard Semantic formats (TL;DR, Breaking Changes, Action Items). - 🔁 **Resilient AI Failovers**: Built-in support to seamlessly failover to secondary AI providers like Groq, DeepSeek, Anthropic, or local Ollama if your main provider hits a rate limit or timeout. - 🕒 **Interactive Timeline**: Ships with a beautiful, pre-styled Tailwind CSS + Livewire timeline panel ready right out of the box. - ✍️ **Markdown editor**: Edit summaries with EasyMDE (CodeMirror); stored Markdown renders with `Str::markdown()` on the timeline. - 🚦 **Queue Native**: Completely non-blocking. Interacts gracefully with AI constraints leveraging Laravel's native queuing and backoff mechanics. - 🔒 **Configurable Access**: Easily wrap the timeline behind your application's existing authentication UI logic. Installation ------------ [](#installation) You can install the package via Composer: ``` composer require mdimannyit/changelog-tracker ``` ### Livewire 4 and Composer versions [](#livewire-4-and-composer-versions) **Livewire 4** apps should require **1.1.0 or newer** (installs that support `livewire/livewire` 3 and 4): ``` composer require mdimannyit/changelog-tracker:^1.1 ``` **Livewire 3** apps may use `^1.0` or `^1.1`. See [CHANGELOG.md](CHANGELOG.md) for what changed in 1.1.x. 1. **Publish the Configuration** ``` php artisan vendor:publish --tag="changelog-config" ``` 2. **Optional: append missing `.env` keys** (OpenAI, fallback, optional UI vars). Skips any key that already exists: ``` php artisan changelog:sync-env --dry-run php artisan changelog:sync-env ``` 3. **Run Migrations**The package will seamlessly publish a new `changelog_entries` table directly into your application's existing database to store the timeline events: ``` php artisan migrate ``` 4. **Configure AI Drivers**Add your Primary API key to your `.env` file to enable AI summaries. You can optionally configure an automatic Fallback driver (e.g., Groq or Ollama) to guarantee the changelog generates correctly even if OpenAI limits are exhausted! ``` OPENAI_API_KEY="sk-your-openai-api-key" OPENAI_MODEL="gpt-4o" # Optional: Automatic Fallback Driver (Example: Groq) CHANGELOG_FALLBACK_ENABLED=true CHANGELOG_FALLBACK_API_KEY="gsk-your-groq-key" CHANGELOG_FALLBACK_BASE_URI="https://api.groq.com/openai/v1" CHANGELOG_FALLBACK_MODEL="llama3-70b-8192" ``` 5. **Optional: publish Blade views** so you can edit markup and classes to match your design system: ``` php artisan vendor:publish --tag=changelog-views ``` Overrides live under `resources/views/vendor/changelog/`. Laravel resolves the `changelog::` namespace against that folder first, then the package. If you published the timeline view and embed the component, merge changes from the package view (EasyMDE `@assets`, markdown display styles) or remove `resources/views/vendor/changelog/livewire/changelog-timeline.blade.php` so the package default is used again. Composer does not overwrite published files. Styling, layout, and embedding ------------------------------ [](#styling-layout-and-embedding) ### Match your app template (full page) [](#match-your-app-template-full-page) The package route renders `ChangelogTimeline` as a **full page** only when the current route name is `changelog.index` (or any name listed in `full_page_route_names` in config). In that case the component applies `layout_view` and `page_title`. - **Default:** `layout_view` is `changelog::layouts.app` (CDN Tailwind; EasyMDE ships from the timeline view via Livewire assets). Good for trying the feature quickly. - **Production:** set `layout_view` in published `config/changelog.php` to your shell, for example `components.layouts.app`, so the changelog uses the same layout, Vite assets, and typography as the rest of the site. Your layout should include `@livewireStyles` / `@livewireScripts` (and `@stack('changelog-styles')` / `@stack('changelog-scripts')` if you push assets from customized views). Set `layout_view` to `null` or `''` to skip an explicit `->layout()` call and use your Livewire default page layout (see `config/livewire.php`, for example `component_layout` on Livewire 4). Env overrides (optional): `CHANGELOG_LAYOUT`, `CHANGELOG_PAGE_TITLE`, `CHANGELOG_ROUTE_NAME`, `CHANGELOG_TIMELINE_VIEW`. ### Embed in any page (not the package URL) [](#embed-in-any-page-not-the-package-url) Register the component anywhere Livewire runs: ``` ``` On routes **other** than the configured full-page names, the component returns **only** the timeline markup (no outer `layout_view`), so it sits inside your existing `@extends` / layout and picks up your CSS. **Markdown summaries:** rendered HTML uses the class `changelog-markdown` with scoped CSS registered via Livewire `@assets`. You do **not** need to add `@tailwindcss/typography` for lists and headings to look right. If you prefer Tailwind Typography’s `prose` theme instead, publish the timeline view, remove `changelog-markdown` / the markdown `@assets` block, and apply your own `prose` classes. **EasyMDE:** the timeline view registers EasyMDE CSS and JS with Livewire `@assets`, so the modal works on the package route and when you embed the component. Publish the Blade view if you need pinned or self-hosted EasyMDE URLs instead of unpkg. ### Rename the package route [](#rename-the-package-route) Publish config and set `route_prefix`, `middleware`, and `route_name`. The route file uses `route_name` for `Route::…->name(...)`. If you add another named route that points at `ChangelogTimeline::class`, add that name to `full_page_route_names` so it still gets layout + title. Usage ----- [](#usage) ### 1. Recording an Event [](#1-recording-an-event) Whenever a notable action happens in your application, call the `Changelog` facade. Parameter names match `ChangelogRecorderService::record()`: ``` use MannyDesignedIt\ChangelogTracker\Facades\Changelog; Changelog::record( title: 'Product inventory adjusted', raw_change: [ 'old_stock' => 10, 'new_stock' => 45, 'user' => auth()->user()?->name, ], source_type: 'App\\Models\\Product', actor_user_id: auth()->id(), ); ``` `actor_user_id` is optional; when omitted, the current authenticated user id is used when available. Put any external identifier (for example a product id) inside `raw_change` so the AI prompt still has full context. Once recorded, a queued job event automatically kicks off in the background to communicate with your AI Provider and draft a rich Markdown summary. ### 2. The Timeline Panel & Markdown Editor [](#2-the-timeline-panel--markdown-editor) By default, you can view your real-time changelog timeline at the URL from `route_prefix` (see `config/changelog.php`), for example: 👉 **`your-domain.com/admin/changelog`** You can also embed the same UI with `` on any other page (see **Styling, layout, and embedding** above). From this beautifully styled Livewire timeline, you can visually observe actions taking place. - **Manual Adjustments:** Click the "New Entry" or "Edit" buttons to launch the inline Markdown Text Editor to manually document features or overrule AI suggestions. - **Status Control:** Alter the visibility states (`Processed`, `Pending`, `Failed`) of any item effortlessly right from the modal UI. ### 3. Securing the Timeline Route [](#3-securing-the-timeline-route) By default, the package leverages the standard `web` middleware, meaning the page is accessible publicly. You should restrict access to this page by updating the middleware settings inside your published `config/changelog.php`: ``` // config/changelog.php return [ 'route_prefix' => 'admin/changelog', // Add your auth middleware here to secure the panel 'middleware' => ['web', 'auth', 'can:view-changelog'], // ... ]; ``` Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel 11.x, 12.x, or 13.x - Livewire 3.x or 4.x (this package declares `^3.0|^4.0`). On Livewire 4, full-page changelog routes use `Route::livewire()` when that macro is available; Livewire 3 continues to use `Route::get(..., Component::class)`. - An Active Queue Worker (e.g., `php artisan queue:work` or Laravel Horizon) to process the AI generation requests in the background. If you upgrade an app from Livewire 3 to 4, follow the [official upgrade guide](https://livewire.laravel.com/docs/4.x/upgrading). Remove or replace `livewire/volt` if you are not using Volt on v4; check your Volt version’s Livewire constraint in Composer. License ------- [](#license) MIT. See [LICENSE](LICENSE) in this repository. ### Health Score 39 — LowBetter than 84% of packages Maintenance88 Actively maintained with recent releases Popularity4 Limited adoption so far Community6 Small or concentrated contributor base Maturity50 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 5 Last Release 58d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/16739bfac400a792a192691d4fdf6102e00227e8a0113c3260f72da3d57a1cdf?d=identicon)[mdimannyit](/maintainers/mdimannyit) --- Top Contributors [![mdimannyit](https://avatars.githubusercontent.com/u/8341182?v=4)](https://github.com/mdimannyit "mdimannyit (3 commits)") ### Embed Badge ![Health badge](/badges/mdimannyit-changelog-tracker/health.svg) ``` [![Health](https://phpackages.com/badges/mdimannyit-changelog-tracker/health.svg)](https://phpackages.com/packages/mdimannyit-changelog-tracker) ``` ### Alternatives [livewire/flux The official UI component library for Livewire. 9466.8M119](/packages/livewire-flux)[jantinnerezo/livewire-alert This package provides a simple alert utilities for your livewire components. 8111.3M20](/packages/jantinnerezo-livewire-alert)[tallstackui/tallstackui TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications. 719160.4k12](/packages/tallstackui-tallstackui)[psalm/plugin-laravel Psalm plugin for Laravel 3325.1M337](/packages/psalm-plugin-laravel)[venturedrake/laravel-crm A free open source CRM built as a package for laravel projects 39910.0k](/packages/venturedrake-laravel-crm)[tomshaw/electricgrid A feature-rich Livewire package designed for projects that require dynamic, interactive data tables. 119.2k](/packages/tomshaw-electricgrid) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)