Filament Documentation Laravel Package

Breaking Changes

• Minimum Filament version bumped from ^4.0 to ^4.8 — required due to the new PageConfiguration parameter added to Page::routes() in filamentphp/filament#19225

What's Changed

• Fix DocumentationPage::routes() method signature to be compatible with Filament's PageConfiguration parameter
• Update composer.json to require filament/filament: ^4.8

Breaking Changes

• Minimum Filament version bumped from ^5.0 to ^5.3 — required due to the new PageConfiguration parameter added to Page::routes() in filamentphp/filament#19225

What's Changed

• Fix DocumentationPage::routes() method signature to be compatible with Filament's PageConfiguration parameter
• Update composer.json to require filament/filament: ^5.3

What's Changed

• Add Laravel 13.x support (CI test matrix updated for Laravel 13)

Fixed

• Use DocumentationPage::getUrl() for markdown link generation instead of manual URL concatenation, fixing malformed URLs when panel path is empty

Fixed

• Use DocumentationPage::getUrl() for markdown link generation instead of manual URL concatenation, fixing malformed URLs when panel path is empty

Fixed

• Use DocumentationPage::getUrl() for markdown link generation instead of manual URL concatenation, fixing malformed URLs when panel path is empty

Changed

• Removed non-functional search component
• Added URL-based navigation with history.pushState for page sharing
• Override routes() to allow encoded forward slashes in pageSlug parameter

Changed

• Removed non-functional search component
• Added URL-based navigation with history.pushState for page sharing
• Override routes() to allow encoded forward slashes in pageSlug parameter

Changed

• Removed non-functional search component
• Added URL-based navigation with history.pushState for page sharing
• Override routes() to allow encoded forward slashes in pageSlug parameter
• Fixed $view property and getSlug() signature to match Filament v3 latest

Fixed

• Replace Tailwind utility classes with custom CSS for Filament v4/v5 compatibility
• Fix dark code blocks appearing in light mode (highlight.js theme conflict)
• Switch dark mode to .dark class selector (Filament standard)

Fixed

• Replace Tailwind utility classes with custom CSS for Filament v4/v5 compatibility
• Fix dark code blocks appearing in light mode (highlight.js theme conflict)
• Switch dark mode to .dark class selector (Filament standard)

Fixed

• Replace Tailwind utility classes with custom CSS for Filament v4/v5 compatibility
• Fix dark code blocks appearing in light mode (highlight.js theme conflict)
• Switch dark mode to .dark class selector (Filament standard)

Fixed

• Use <x-filament::icon> component instead of direct <x-heroicon-*> in sidebar navigation, fixing InvalidArgumentException: Unable to locate a class or view for component [heroicon-m-chevron-right] caused by Filament's DisableBladeIconComponents middleware

Full Changelog: https://github.com/jeffersongoncalves/filament-documentation/compare/v3.0.0...v3.0.1

Fixed

• Use <x-filament::icon> component instead of direct <x-heroicon-*> in sidebar navigation, fixing InvalidArgumentException: Unable to locate a class or view for component [heroicon-m-chevron-right] caused by Filament's DisableBladeIconComponents middleware

Full Changelog: https://github.com/jeffersongoncalves/filament-documentation/compare/v2.0.0...v2.0.1

Fixed

• Use <x-filament::icon> component instead of direct <x-heroicon-*> in sidebar navigation, fixing InvalidArgumentException: Unable to locate a class or view for component [heroicon-m-chevron-right] caused by Filament's DisableBladeIconComponents middleware

Full Changelog: https://github.com/jeffersongoncalves/filament-documentation/compare/v1.0.0...v1.0.1

Initial Release (Filament v5)

• Markdown-based documentation inside Filament admin panels
• YAML frontmatter support (title, path, order)
• GitHub Flavored Markdown rendering with CommonMark
• Syntax highlighting via highlight.js with copy-to-clipboard
• Dynamic sidebar with nested directory support (collapsible groups)
• Heading permalinks for deep linking
• Relative .md links auto-converted to panel routes
• Light and dark mode support
• Authorization control via viewDocumentation gate
• Configurable cache for parsed content
• Artisan install command (php artisan docs:install)
• Assets lazy-loaded via x-load-css / x-load-js
• ServiceProvider using spatie/laravel-package-tools
• Navigation icon supports BackedEnum (Heroicon enum)

Requirements

• PHP 8.2+
• Laravel 12+
• Filament 5.x
• Livewire 4.x

Initial Release (Filament v4)

• Markdown-based documentation inside Filament admin panels
• YAML frontmatter support (title, path, order)
• GitHub Flavored Markdown rendering with CommonMark
• Syntax highlighting via highlight.js with copy-to-clipboard
• Dynamic sidebar with nested directory support (collapsible groups)
• Heading permalinks for deep linking
• Relative .md links auto-converted to panel routes
• Light and dark mode support
• Authorization control via viewDocumentation gate
• Configurable cache for parsed content
• Artisan install command (php artisan docs:install)
• Assets lazy-loaded via x-load-css / x-load-js
• ServiceProvider using spatie/laravel-package-tools
• Navigation icon supports BackedEnum (Heroicon enum)

Requirements

• PHP 8.2+
• Laravel 11+
• Filament 4.x
• Livewire 3.x

Initial Release (Filament v3)

• Markdown-based documentation inside Filament admin panels
• YAML frontmatter support (title, path, order)
• GitHub Flavored Markdown rendering with CommonMark
• Syntax highlighting via highlight.js with copy-to-clipboard
• Dynamic sidebar with nested directory support (collapsible groups)
• Heading permalinks for deep linking
• Relative .md links auto-converted to panel routes
• Light and dark mode support
• Authorization control via viewDocumentation gate
• Configurable cache for parsed content
• Artisan install command (php artisan docs:install)
• Assets lazy-loaded via x-load-css / x-load-js
• ServiceProvider using spatie/laravel-package-tools

Requirements

• PHP 8.1+
• Laravel 10+
• Filament 3.x
• Livewire 3.x