Download the PHP package blackpig-creatif/grimoire without Composer

Grimoire

In-panel documentation for FilamentPHP v5 applications.

Grimoire lets you embed rich, versioned documentation directly inside your Filament admin panel. Organise content into Tomes (top-level books) and Chapters (individual pages), author in Markdown with YAML frontmatter, and edit chapters inline without leaving the panel.

Requirements

• PHP 8.2+
• Laravel 11 or 12
• Filament v5

Installation

Publish the config (optional):

Plugin Registration

Register the plugin in your Filament panel provider:

Registering a Tome

A Tome is a top-level documentation section. Register one in your AppServiceProvider::boot():

Then scaffold the required Filament stubs:

Adding Chapters

This generates a Filament page stub and a Markdown file at resources/grimoire/my-docs/my-chapter.md. Add content with YAML frontmatter:

Extending a Tome

Override or add chapters to any Tome (including vendor Tomes) from your app:

Local chapters take priority over vendor chapters on slug collision — useful for overriding package documentation with app-specific notes.

Permissions

Access to view and edit documentation is controlled via config/grimoire.php:

Each key accepts one of the following:

null (default behaviour)

• view: all authenticated users may read chapters
• edit: no one may edit chapters

A Laravel Gate ability name

Define the ability in AuthServiceProvider (or a dedicated GrimoirePolicy):

A Class@method string

The method receives the authenticated user as its only argument and must return a boolean.

A closure (local development only)

Closures work when config is not cached, making them convenient for local development. They cannot be used in production with php artisan config:cache.

Inline Editing

Authenticated users with edit permission can edit chapter content directly in the panel. Click Edit on any chapter page to switch to an inline editor with a Markdown editor for content and a YAML editor for frontmatter.

Locale Support

Grimoire supports two locale strategies for multilingual documentation. Configure in config/grimoire.php:

Suffix strategy — place locale variants alongside the default file:

Directory strategy — organise by locale subdirectory:

Grimoire resolves files in order: current locale → fallback locale → locale-neutral.

Built-in Self-Documentation

Enable Grimoire's own documentation Tome inside your panel with ->withDocs():

Caching

For production, cache the navigation tree:

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

• Blackpig Creatif
• All Contributors

License

The MIT License (MIT). Please see License File for more information.