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

Scan Only Dirty Files

Scan only files with uncommitted git changes, similar to Laravel Pint's --dirty option:

# Scan only uncommitted files
vendor/bin/filacheck --dirty

# Auto-fix only dirty files
vendor/bin/filacheck --dirty --fix

# Preview fixes for dirty files only
vendor/bin/filacheck --dirty --dry-run

Auto-fixing Issues (Beta)

FilaCheck can automatically fix many issues it detects:

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

# Preview suggested fixes without modifying files
vendor/bin/filacheck --dry-run

# 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.

Configuration

You can optionally publish the config file to disable individual rules:

php artisan vendor:publish --tag=filacheck-config

To disable a rule, set enabled to false:

// config/filacheck.php
'deprecated-reactive' => [
    'enabled' => false,
],

All rules are enabled by default.

Available Rules (15 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 (13 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
`deprecated-test-methods`	Detects deprecated test methods like `setActionData()`, `mountTableAction()`, `assertFormSet()`, etc.	Partial

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 19 additional rules for performance optimization, security, best practices, and UX suggestions.

Performance Rules (4 rules)

Rule	Description	Fixable
`too-many-columns`	Warns when tables have more than 10 columns	No
`large-option-list-searchable`	Suggests `->searchable()` for lists with 10+ options	No
`heavy-closure-in-format-state`	Detects database queries inside `formatStateUsing()` closures that cause N+1 issues	No
`stats-widget-polling-not-disabled`	Warns when `StatsOverviewWidget` uses the default 5-second polling interval	Yes

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 (8 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
`enum-missing-filament-interfaces`	Warns when enums cast in Eloquent models are missing Filament interfaces like `HasLabel`	No

UX Suggestions Rules (5 rules)

Rule	Description	Fixable
`flat-form-overload`	Warns when form schema has more than 8 fields without any layout grouping (Sections, Tabs, Fieldsets, etc.)	No
`relationship-select-not-searchable`	Warns when `Select` with `relationship()` is missing `searchable()`	No
`missing-table-filters`	Warns when table has filterable columns (boolean, badge, icon) but no filters defined	No
`table-without-searchable-columns`	Warns when table has text columns but none are searchable	No
`filter-missing-indicator`	Warns when custom `Filter` has a `schema()` but no `indicateUsing()` or `indicator()` for active filter badges	No

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

Package info

Statistics

Security