FilaCheck

• Installation
• Usage
  • Scan Only Dirty Files
  • Auto-fixing Issues (Beta)
• Configuration
• Available Rules (15 Free)
  • Best Practices (2 rules)
  • Deprecated Code (13 rules)
• Example Output
• Exit Codes
• FilaCheck Pro
  • Performance Rules (4 rules)
  • Security Rules (1 rule)
  • Best Practices Rules (8 rules)
  • UX Suggestions Rules (5 rules)
• CI Integration
  • GitHub Actions
• Contributing
• License

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)

#Deprecated Code (13 rules)

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

#Performance Rules (4 rules)

#Security Rules (1 rule)

#Best Practices Rules (8 rules)

#UX Suggestions Rules (5 rules)

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.