PHPackages alessandronuunes/filament-plugin - 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. alessandronuunes/filament-plugin ActiveLibrary[Utility & Helpers](/categories/utility) alessandronuunes/filament-plugin ================================ Scaffold Filament v4 plugins with one Artisan command. v1.0.2(3mo ago)10MITPHPPHP ^8.2|^8.3|^8.4 Since Feb 18Pushed 3mo agoCompare [ Source](https://github.com/alessandronuunes/filament-plugin)[ Packagist](https://packagist.org/packages/alessandronuunes/filament-plugin)[ Docs](https://github.com/alessandronuunes/filament-plugin)[ RSS](/packages/alessandronuunes-filament-plugin/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (4)Versions (3)Used By (0) Filament Plugin Scaffolder ========================== [](#filament-plugin-scaffolder) Scaffold Filament v3/v4/v5 plugins with Artisan commands. Generates the full structure: ServiceProvider, Plugin class, config, views, translations, install command, and more in `packages/` or a custom path. Features -------- [](#features) CommandDescription`make:filament-plugin`Create a new Filament plugin from scratch`filament-plugin:register`Register an existing plugin in the project `composer.json``filament-plugin:page`Create a Filament page inside an existing plugin`filament-plugin:submit`Interactive wizard to submit a plugin to filamentphp.comRequirements ------------ [](#requirements) - PHP 8.2+ - Laravel 11.x or 12.x Installation ------------ [](#installation) ``` composer require alessandronuunes/filament-plugin ``` For local package (monorepo), add to the application `composer.json`: ``` { "repositories": [ { "type": "path", "url": "packages/filament-plugin", "options": { "symlink": true } } ], "require-dev": { "alessandronuunes/filament-plugin": "@dev" } } ``` Then run: ``` composer update alessandronuunes/filament-plugin ``` Configuration ------------- [](#configuration) Publish the config file: ``` php artisan vendor:publish --tag=filament-plugin-config ``` Edit `config/filament-plugin.php`: OptionDescriptionDefault`packages_path`Base directory for local plugins`packages``filamentphp_fork_path`Path to your filamentphp.com fork (env: `FILAMENTPHP_FORK_PATH`)—`default_vendor`Vendor namespace for new plugins`AlessandroNuunes``default_author_name`Author name for `composer.json``AlessandroNuunes``default_author_email`Author email for `composer.json`—The `packages_path` is used by `filament-plugin:register` and `filament-plugin:page` to locate plugins (e.g. `FilamentTest` → `packages/filament-test`). The `filamentphp_fork_path` is used by `filament-plugin:submit` as the default repo path and enables automatic creation of author and plugin files in your fork. Set in `.env`: ``` FILAMENTPHP_FORK_PATH=/Users/you/Workspace/fork/filamentphp.com ``` --- 1. Create a New Plugin ---------------------- [](#1-create-a-new-plugin) ``` php artisan make:filament-plugin FilamentTest ``` The command asks interactively: - **Vendor namespace** (PascalCase) - **Package slug** (kebab-case) - **Description** and **author** (name/email) - **Plugin type:** `panel` (pages, resources, widgets, tenancy) or `standalone` (reusable components) - **Filament version:** 3, 4, 5, or 4|5 (compatible with both) - **Include:** config, views, translations, migrations, install command The plugin is created in `packages/{slug}/` (or `--path=custom/path`). ### Options [](#options) OptionDescription`--path=packages`Base directory for the plugin (default: `packages`)`--force`Overwrite existing directory`--register`Add plugin to `composer.json` and run `composer update``--no-register`Skip adding to `composer.json`### Non-interactive Example [](#non-interactive-example) ``` php artisan make:filament-plugin FilamentTest --path=packages --force --register ``` With `--no-interaction`, the Filament version defaults to 4 or 5. --- 2. Register Existing Plugin --------------------------- [](#2-register-existing-plugin) If the plugin already exists in `packages/` but is not in the project `composer.json`: ``` php artisan filament-plugin:register FilamentTest ``` The command: 1. Finds the plugin in `packages/filament-test` (or configured `packages_path`) 2. Adds the path repository and `require` to `composer.json` 3. Runs `composer update {package}` **Argument:** Plugin name in PascalCase (e.g. `FilamentTest`, `FilamentMember`). If the plugin is not found, check `packages_path` in `config/filament-plugin.php`. --- 3. Create Page Inside a Plugin ------------------------------ [](#3-create-page-inside-a-plugin) After creating or cloning a plugin, add Filament pages with: ``` php artisan filament-plugin:page MyPage --plugin=FilamentTest ``` Creates the class at `src/Pages/MyPage.php` and the view at `resources/views/filament/pages/my-page.blade.php`. ### Arguments and Options [](#arguments-and-options) Argument/OptionRequiredDescription`name`YesPage name in PascalCase (e.g. `ManageSettings`)`--plugin=`YesPlugin name in PascalCase (e.g. `FilamentTest`)`--filament=`When `--no-interaction`Version: `3`, `4`, `5`, or `4|5``--force`NoOverwrite existing class and view`--register`NoAdd page to `->pages([...])` in the Plugin class`--panel=`NoPanel name (comment only in the class)### Examples [](#examples) ``` # Interactive (prompts for Filament version) php artisan filament-plugin:page ManageSettings --plugin=FilamentTest # Non-interactive php artisan filament-plugin:page ManageSettings --plugin=FilamentTest --filament=5 --no-interaction # Register in Plugin and overwrite php artisan filament-plugin:page Settings --plugin=FilamentTest --register --force # With specific panel php artisan filament-plugin:page Billing --plugin=FilamentTest --panel=admin ``` ### Auto-register Page [](#auto-register-page) With `--register`, the command adds the page to `->pages([...])` in the plugin `*Plugin.php`. If the plugin uses `->discoverPages()`, the page is discovered automatically and no manual change is needed. --- 4. Submit Plugin to filamentphp.com ----------------------------------- [](#4-submit-plugin-to-filamentphpcom) Interactive wizard to prepare and submit a plugin to [filamentphp.com](https://filamentphp.com/plugins): ``` php artisan filament-plugin:submit ``` The wizard guides you through: 1. Fork and clone the filamentphp.com repository 2. Selecting a plugin from `packages/` (or entering data manually) 3. Creating a branch (e.g. `add-filament-tabbed-dashboard`) 4. Author profile (new or existing) 5. Plugin data (name, slug, categories, description, etc.) 6. **Create files** — optionally writes `content/authors/{slug}.md` and `content/plugins/{slug}.md` directly into your fork 7. Commit and push instructions 8. Pull Request checklist ### Options [](#options-1) OptionDescription`--repo=`Path to your filamentphp.com clone (default: `FILAMENTPHP_FORK_PATH` or current directory)### Automatic File Creation [](#automatic-file-creation) If `FILAMENTPHP_FORK_PATH` is set in `.env`, the wizard uses it as the default repo path. At the end, it asks: > Create the author and plugin files in your fork now? \[y/N\] If you confirm, it writes the author and plugin markdown files directly. Add avatar and plugin image manually (JPEG, sizes as per filamentphp.com guidelines). ### Author Defaults (Submit Wizard) [](#author-defaults-submit-wizard) Configure in `config/filament-plugin.php` to pre-fill the submit wizard: OptionDescription`author_full_name`Full name for author profile`author_slug`Author slug (e.g. `alessandro-nuunes`)`author_github_url`GitHub profile URL`author_twitter`Twitter/X URL (optional)`author_mastodon`Mastodon URL (optional)`author_sponsor_url`Sponsor URL (optional)`author_bio`Short bio (optional)--- Recommended Workflow -------------------- [](#recommended-workflow) 1. **Create the plugin:** ``` php artisan make:filament-plugin FilamentTest ``` 2. **Register in the project** (if not already): ``` php artisan filament-plugin:register FilamentTest ``` 3. **Add pages:** ``` php artisan filament-plugin:page MyPage --plugin=FilamentTest ``` 4. **Register the plugin in the Filament panel:** ``` // App\Providers\Filament\AdminPanelProvider (or similar) ->plugins([ \YourVendor\FilamentTest\FilamentTestPlugin::make(), ]) ``` 5. **Submit to filamentphp.com** (optional): ``` php artisan filament-plugin:submit ``` --- Structure Generated by `make:filament-plugin` --------------------------------------------- [](#structure-generated-by-makefilament-plugin) ``` packages/{slug}/ ├── src/ │ ├── {Name}Plugin.php # Plugin class (panel type only) │ ├── {Name}ServiceProvider.php │ ├── Pages/ # Pages created with filament-plugin:page │ ├── Support/ │ │ └── ConfigHelper.php │ └── Console/Commands/ # If install command included │ └── InstallCommand.php ├── config/ │ └── {slug}.php ├── resources/ │ ├── views/filament/pages/ │ ├── views/livewire/ │ └── lang/en/ and pt_BR/ # If translations included ├── database/migrations/ # If migrations included ├── composer.json ├── README.md ├── pint.json └── ... ``` --- Troubleshooting --------------- [](#troubleshooting) - **Plugin not found:** Ensure `packages_path` in `config/filament-plugin.php` points to the directory containing your plugins. - **Invalid namespace:** Vendor and namespace must be valid PHP identifiers (no leading numbers). Use PascalCase (e.g. `AlessandroNuunes`). - **Interactive prompts:** Do not pipe input into the command; respond to prompts directly to avoid invalid data. --- Publishing ---------- [](#publishing) 1. Publish the package to GitHub (or GitLab). 2. Others can install via Composer: - **Packagist:** `composer require alessandronuunes/filament-plugin` - **Git repo:** add to `repositories`: `"type": "vcs", "url": "https://github.com/your-username/filament-plugin"` then `composer require alessandronuunes/filament-plugin:dev-main` --- Contributing ------------ [](#contributing) This package is in its **early stages** and we would love your help to improve it. Ideas, bug reports, pull requests, and feedback are all welcome. Ways you can contribute: - Open issues for bugs or feature requests - Submit pull requests for improvements - Share your experience or suggestions - Help improve the documentation Together we can make this scaffolder more useful for the Filament community. Thank you! --- License ------- [](#license) MIT. See [LICENSE.md](LICENSE.md). ### Health Score 38 — LowBetter than 85% of packages Maintenance82 Actively maintained with recent releases Popularity2 Limited adoption so far Community6 Small or concentrated contributor base Maturity52 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 2 Last Release 90d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/4d53fc7e3f13c6a03262261f5f6e670d8ae140b90878dd51eca3d18d27ab7423?d=identicon)[alessandronuunes](/maintainers/alessandronuunes) --- Top Contributors [![alessandronuunes](https://avatars.githubusercontent.com/u/13227884?v=4)](https://github.com/alessandronuunes "alessandronuunes (5 commits)") --- Tags pluginlaravelscaffoldfilamentfilament-plugin ### Code Quality Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/alessandronuunes-filament-plugin/health.svg) ``` [![Health](https://phpackages.com/badges/alessandronuunes-filament-plugin/health.svg)](https://phpackages.com/packages/alessandronuunes-filament-plugin) ``` ### Alternatives [barryvdh/laravel-ide-helper Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion. 14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[awcodes/filament-table-repeater A modified version of the Filament Forms Repeater to display it as a table. 262815.1k5](/packages/awcodes-filament-table-repeater)[interaction-design-foundation/laravel-geoip Support for multiple Geographical Location services. 17221.0k3](/packages/interaction-design-foundation-laravel-geoip)[awcodes/recently Easily track and access recently viewed records in your filament panels. 4224.3k](/packages/awcodes-recently)[howdu/filament-record-switcher Resource level navigation with search 1512.5k](/packages/howdu-filament-record-switcher) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)