README

A CLI CRUD admin panel for Laravel, inspired by Filament and Laravel Nova. Built with laravel/prompts and nunomaduro/termwind.

Requirements

• PHP ^8.4
• Laravel 12.x | 13.x

Installation

composer require repat/cli-crud

The service provider will be automatically registered.

Configuration

Publish the configuration file:

php artisan vendor:publish --tag=cli-crud-config

This will create config/cli-crud.php:

return [
    'resources' => [
        'path' => app_path('CliCrud/Resources'),
        'namespace' => 'App\\CliCrud\\Resources',
    ],
    'actions' => [
        'path' => app_path('CliCrud/Actions'),
        'namespace' => 'App\\CliCrud\\Actions',
    ],
    'pagination' => [
        'per_page' => 15,
        'relation_per_page' => 10,
    ],
    'authorization' => [
        'enabled' => false,
    ],
];

Usage

Running the CLI

php artisan cli-crud

This opens an interactive menu where you can:

• Select a resource (Model)
• List records (paginated)
• Search for records
• View record details
• Create new records
• Delete records (soft delete, force delete, restore)
• Run an action for (a) record(s)
• View custom cards & charts for metrics
• View images (kitty and iTerm protocol)

Screenshots

Resources

See docs/RESOURCES.md for creating resources, the generated structure, auto-generated fields from a model, and available properties.

Fields

See docs/FIELDS.md for all field types, relations, and options.

Search

See docs/SEARCH.md for declaring searchable fields, the $search override, and custom search engine integration.

Actions

See docs/ACTIONS.md for creating and attaching Nova-style actions, including queued and destructive variants.

Cards

See docs/CARDS.md for Chart, Image and Custom cards in the detail view.

Authorization

See docs/AUTHORIZATION.md for enabling Laravel Gates/Policies integration.

Roadmap

• Dashboards
• Action log (audit trail)
• Plugins
• Export (CSV, JSON)
• TUI testing
• Code Cleanup

Testing

composer test

License

MIT