README

Static analysis for Filament v4/v5 projects. Detect deprecated patterns and code issues.

FilaCheck is like Pint but for Filament - run it after AI agents generate code or during CI to catch common issues.

Installation

composer require laraveldaily/filacheck --dev

Usage

You can run Filacheck as a Terminal command.

# Scan default app/Filament directory
vendor/bin/filacheck

# Scan specific directory
vendor/bin/filacheck app/Filament/Resources

# Show detailed output with categories
vendor/bin/filacheck --detailed

Auto-fixing Issues (Beta)

FilaCheck can automatically fix many issues it detects:

# Fix issues automatically
vendor/bin/filacheck --fix

# Fix with backup files (creates .bak files before modifying)
vendor/bin/filacheck --fix --backup

Warning

The auto-fix feature is in early stages. Always ensure your code is committed to version control (e.g., Git/GitHub) before running --fix so you can easily review and revert changes if needed.

Available Rules (14 Free)

FilaCheck includes the following rules for detecting deprecated code patterns and common issues:

Best Practices (2 rules)

Rule	Description	Fixable
`action-in-bulk-action-group`	Detects `Action::make()` inside `BulkActionGroup::make()` which should be `BulkAction::make()`	Yes
`wrong-tab-namespace`	Detects wrong `Tab` namespace - should be `Filament\Schemas\Components\Tabs\Tab`	Yes

Deprecated Code (12 rules)

Rule	Description	Fixable
`deprecated-reactive`	Detects `->reactive()` which should be replaced with `->live()`	Yes
`deprecated-action-form`	Detects `->form()` on Actions which should be `->schema()`	Yes
`deprecated-filter-form`	Detects `->form()` on Filters which should be `->schema()`	Yes
`deprecated-placeholder`	Detects `Placeholder::make()` which should be `TextEntry::make()->state()`	No
`deprecated-mutate-form-data-using`	Detects `->mutateFormDataUsing()` which should be `->mutateDataUsing()`	Yes
`deprecated-empty-label`	Detects `->label('')` which should be `->hiddenLabel()` (or `->iconButton()` on Actions)	Yes
`deprecated-forms-get`	Detects `use Filament\Forms\Get` or `callable $get` which should use `Filament\Schemas\Components\Utilities\Get`	Yes
`deprecated-forms-set`	Detects `use Filament\Forms\Set` or `callable $set` which should use `Filament\Schemas\Components\Utilities\Set`	Yes
`deprecated-image-column-size`	Detects `->size()` on ImageColumn which should be `->imageSize()`	Yes
`deprecated-view-property`	Detects `$view` property not declared as `protected string`	Yes
`deprecated-bulk-actions`	Detects `->bulkActions()` which should be replaced with `->toolbarActions()`	Yes
`deprecated-url-parameters`	Detects deprecated URL parameters like `tableFilters`, `activeTab`, `tableSearch`, etc.	Yes

Example Output

Scanning: app/Filament

..x..x.......

deprecated-reactive (Deprecated Code)
  app/Filament/Resources/UserResource.php
    Line 45: The `reactive()` method is deprecated.
      → Use `live()` instead of `reactive()`.

deprecated-action-form (Deprecated Code)
  app/Filament/Resources/PostResource.php
    Line 78: The `form()` method is deprecated on Actions.
      → Use `schema()` instead of `form()`.

Rules: 4 passed, 2 failed
Issues: 2 warning(s)

Exit Codes

0 - No violations found
1 - Violations found

This makes FilaCheck perfect for CI pipelines.

FilaCheck Pro

FilaCheck Pro adds 13 additional rules for performance optimization, security, and best practices.

Performance Rules (4 rules)

Rule	Description	Fixable
`too-many-columns`	Warns when tables have more than 10 columns	No
`table-defer-loading`	Suggests adding `->deferLoading()` to tables	No
`table-missing-eager-loading`	Suggests enabling `Model::preventLazyLoading()` (or `Model::shouldBeStrict()`) in your `AppServiceProvider` to catch N+1 queries	No
`large-option-list-searchable`	Suggests `->searchable()` for lists with 10+ options	No

Security Rules (2 rules)

Rule	Description	Fixable
`file-upload-missing-accepted-file-types`	Warns when `FileUpload` or `SpatieMediaLibraryFileUpload` is missing `acceptedFileTypes()` or `image()`	No
`action-missing-authorization`	Warns when `Action`, `BulkAction`, `ImportAction`, or `ExportAction` is missing `hidden()`, `visible()`, or `authorize()`	No

Best Practices Rules (7 rules)

Rule	Description	Fixable
`string-icon-instead-of-enum`	Detects string icons like `'heroicon-o-pencil'` - use `Heroicon::Pencil` enum instead	Yes
`string-font-weight-instead-of-enum`	Detects string font weights like `'bold'` - use `FontWeight::Bold` enum instead	Yes
`deprecated-notification-action-namespace`	Detects deprecated `Filament\Notifications\Actions\Action` namespace - use `Filament\Actions\Action` instead	Yes
`unnecessary-unique-ignore-record`	Detects `->unique(ignoreRecord: true)` which is now the default in Filament v4	Yes
`custom-theme-needed`	Detects Blade files using Tailwind CSS classes without a custom Filament theme configured	No
`file-upload-missing-max-size`	Warns when `FileUpload` or `SpatieMediaLibraryFileUpload` is missing `maxSize()`	No
`bulk-action-missing-deselect`	Warns when `BulkAction` is missing `deselectRecordsAfterCompletion()`	Yes

Get FilaCheck Pro at filamentexamples.com/filacheck.

CI Integration

GitHub Actions

name: FilaCheck

on: [push, pull_request]

jobs:
  filacheck:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: '8.2'

      - name: Install dependencies
        run: composer install --no-progress --prefer-dist

      - name: Run FilaCheck
        run: vendor/bin/filacheck

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License. See LICENSE for details.

laraveldaily / filacheck

Maintainers

Details