Download the PHP package kirschbaum-development/filament-diffs without Composer
On this page you can find all versions of the php package kirschbaum-development/filament-diffs. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kirschbaum-development/filament-diffs
More information about kirschbaum-development/filament-diffs
Files in kirschbaum-development/filament-diffs
Package filament-diffs
Short Description A Filament plugin that wraps @pierre/diffs to render beautiful file diffs and syntax-highlighted code views.
License MIT
Homepage https://github.com/kirschbaum-development/filament-diffs
Informations about the package filament-diffs
Syntax-highlighted file viewing and visual diff rendering for Filament infolists. Powered by @pierre/diffs.
Components
FileEntry
Renders any text-based content with syntax highlighting. Useful for displaying raw file contents, stored code, API payloads, or any structured text directly in an infolist.
FileDiffEntry
Renders a side-by-side diff between two versions of content with syntax highlighting. Useful for comparing model versions, reviewing changes, or showing before/after states.
Requirements
- PHP 8.1+
- Filament 3.x, 4.x, or 5.x
Installation
Then register the plugin in your panel provider:
Usage
FileEntry
Use FileEntry in any infolist to render a field's value with syntax highlighting. The state is resolved from the record attribute matching the entry name:
You can override the state entirely using a closure:
FileDiffEntry
Use FileDiffEntry to render a side-by-side diff between two strings. Both ->old() and ->new() accept a string or a closure that receives the current record. A null value is treated as an empty string, making it easy to represent newly created files.
Setting the Language
Both components detect the syntax highlighting language from the file name. You can also set it explicitly using any Shiki language identifier — this takes precedence over file name detection:
Passing Options
Both components accept an ->options() array that is passed directly to the underlying @pierre/diffs components, giving you access to the full range of configuration including themes, diff styles, and more:
See the @pierre/diffs documentation for all available options.
Configuration
Default Theme
Publish the config file to set a default theme across all components in your application:
You can also set a default theme per panel via the plugin, which takes precedence over the config file:
Theme Precedence
Themes are resolved in the following order (highest priority first):
- Per-component
->options(['theme' => '...']) - Panel plugin
FilamentDiffsPlugin::make()->defaultTheme('...') - Config file
filament-diffs.default_theme
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Travis Obregon
- Kirschbaum Development Group
- @pierre/diffs by The Pierre Computer Co.
- All Contributors
Sponsorship
Development of this package is sponsored by Kirschbaum Development Group, a developer driven company focused on problem solving, team building, and community. Learn more about us or join us!
License
The MIT License (MIT). Please see License File for more information.
All versions of filament-diffs with dependencies
filament/filament Version ^3.0 || ^4.0 || ^5.0
spatie/laravel-package-tools Version ^1.15.0