FilaCheck

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 or Artisan command.

Standalone

# 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

Laravel Artisan Command

php artisan filacheck
php artisan filacheck app/Filament/Resources
php artisan 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

FilaCheck includes 6 rules for detecting deprecated code patterns:

Deprecated Code

Rule	Description
deprecated-reactive	Detects ->reactive() which should be replaced with ->live()
deprecated-action-form	Detects ->form() on Actions which should be ->schema()
deprecated-filter-form	Detects ->form() on Filters which should be ->schema()
deprecated-placeholder	Detects Placeholder::make() which should be TextEntry::make()->state()
deprecated-mutate-form-data-using	Detects ->mutateFormDataUsing() which should be ->mutateDataUsing()
deprecated-empty-label	Detects ->label('') which should be ->hiddenLabel()

---

Example Output

FilaCheck v0.1
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 (Coming Soon)

I'm working on FilaCheck Pro with additional performance and best practices rules:

Performance Rules (planned)

Rule	Description
too-many-columns	Warns when tables have more than 10 columns
select-relationship-preload	Detects Select with ->relationship() missing ->preload()
table-defer-loading	Suggests adding ->deferLoading() to tables
table-missing-eager-loading	Detects relationship columns without eager loading
large-option-list-searchable	Suggests ->searchable() for lists with 10+ options

Best Practices Rules (planned)

Rule	Description
string-icon-instead-of-enum	Detects string icons like 'heroicon-o-pencil' - use Heroicon::Pencil enum instead
unnecessary-unique-ignore-record	Detects ->unique(ignoreRecord: true) which is now the default in Filament v4

Interested? Star this repo and follow @PovilasKorop for updates.

---

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.