PHPackages jeancarloms/filament-release-notes - 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. [Admin Panels](/categories/admin) 4. / 5. jeancarloms/filament-release-notes ActiveLibrary[Admin Panels](/categories/admin) jeancarloms/filament-release-notes ================================== Filament plugin to display Git release notes with search, pagination, and Shield permissions. v1.0.8(4mo ago)144↓93.2%MITPHPPHP ^8.2 Since Mar 20Pushed 4mo agoCompare [ Source](https://github.com/JeanCarloMS/FilamentReleaseNotes)[ Packagist](https://packagist.org/packages/jeancarloms/filament-release-notes)[ RSS](/packages/jeancarloms-filament-release-notes/feed)WikiDiscussions main Synced yesterday READMEChangelogDependencies (6)Versions (10)Used By (0) JeanCarloMS Filament Release Notes ================================== [](#jeancarloms-filament-release-notes) Filament plugin that displays a timeline of commits from the current Git repository as a "Release Notes" page. Includes: - real pagination over `git log` - commit message keyword search - direct links to commits on GitHub - `Filament Shield` integration - per-panel configuration Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel 12+ - Filament 3.3+ - `bezhansalleh/filament-shield` - local access to the project's Git repository Installation ------------ [](#installation) ``` composer require JeanCarloMS/filament-release-notes ``` Git Safe Directory ------------------ [](#git-safe-directory) If you receive this error in your app it is because the owner of the directory and the PHP of the web server are differents > No fue posible leer el historial Git. Git rechazó el repositorio por ownership. El proceso web probablemente corre con otro usuario distinto al dueño del repo. Detalle: fatal: detected dubious ownership in repository at '/var/www/html/ros' To add an exception for this directory, call: git config --global --add safe.directory /var/www/html/ros Solution, run this command: ``` That command tells Git, at the system-wide level, to trust that directory even if the repository owner does not match the user running the command. ``` ``` sudo git config --system --add safe.directory /var/www/html/your_project ``` If you want to revert: ``` sudo git config --system --unset-all safe.directory /var/www/html/your_project ``` Custom Filament Theme --------------------- [](#custom-filament-theme) If the plugin will be used inside a Filament panel, you must create a custom theme for that panel so Tailwind can include the plugin styles. Add the following line to that theme's CSS file: ``` @source '../../../../vendor/jeancarloms/filament-release-notes/resources/views/**/*.blade.php'; ``` This ensures the plugin styles are loaded correctly in the panel. Publish Configuration --------------------- [](#publish-configuration) ``` php artisan vendor:publish --tag=filament-release-notes-config ``` Register The Plugin In Filament ------------------------------- [](#register-the-plugin-in-filament) ``` use JeanCarloMS\FilamentReleaseNotes\FilamentReleaseNotesPlugin; FilamentReleaseNotesPlugin::make() ->navigationGroup('System') ->navigationSort(11) ->navigationIcon('heroicon-o-sparkles') ->slug('release-notes') ->title('Release Notes') ->heading('Release Notes') ->subheading('Browse the visual history of changes in the current repository.') ->defaultPerPage(100) ->perPageOptions([25, 50, 100, 150, 200]) ->repositoryPath(base_path()) ``` Shield ------ [](#shield) The page uses `HasPageShield`, so the required permission is: ``` page_ReleaseNotes ``` The plugin will attempt to create that permission automatically if the `permissions` table exists. Configuration ------------- [](#configuration) File: `config/filament-release-notes.php` Available options: - `git_binary` - `repository_path` - `branch` - `default_per_page` - `per_page_options` - `cache_store` - `cache_ttl` - `date_format` Limitations ----------- [](#limitations) - search only runs against the commit message - the repository must exist locally - commit links depend on `remote.origin.url` Packagist Publishing -------------------- [](#packagist-publishing) 1. Upload this package to a separate public Git repository. 2. Create a semantic tag, for example `v1.0.0`. 3. Register the repository on Packagist. 4. Run `composer require JeanCarloMS/filament-release-notes` in the consuming project. License ------- [](#license) MIT ### Health Score 39 — LowBetter than 84% of packages Maintenance74 Regular maintenance activity Popularity12 Limited adoption so far Community6 Small or concentrated contributor base Maturity53 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 9 Last Release 140d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/f426f1efab315a6198ba0cfe181b08466285578cd7613bedadce82d62a0f0590?d=identicon)[JeanCarloMS](/maintainers/JeanCarloMS) --- Top Contributors [![JeanCarloMS](https://avatars.githubusercontent.com/u/14093722?v=4)](https://github.com/JeanCarloMS "JeanCarloMS (9 commits)") --- Tags laravelgitfilamentrelease notesshield ### Embed Badge ![Health badge](/badges/jeancarloms-filament-release-notes/health.svg) ``` [![Health](https://phpackages.com/badges/jeancarloms-filament-release-notes/health.svg)](https://phpackages.com/packages/jeancarloms-filament-release-notes) ``` ### Alternatives [laravel/horizon Dashboard and code-driven configuration for Laravel queues. 4.2k99.8M349](/packages/laravel-horizon)[laravel/mcp Rapidly build MCP servers for your Laravel applications. 79227.1M210](/packages/laravel-mcp)[illuminate/queue The Illuminate Queue package. 20433.0M1.8k](/packages/illuminate-queue)[spatie/laravel-health Monitor the health of a Laravel application 88212.7M185](/packages/spatie-laravel-health)[illuminate/console The Illuminate Console package. 13046.6M7.2k](/packages/illuminate-console)[psalm/plugin-laravel Psalm plugin for Laravel 3345.4M354](/packages/psalm-plugin-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)