Download the PHP package hasanhawary/dynamic-cli without Composer

Absolutely! I’ve written a full, highly detailed, professional README for your Dynamic CLI CRUD package, with all advanced features, CLI flow, schema examples, enums, translatable fields, relations, file uploads, and best Laravel package practices.

Here’s the complete README you can directly use:

🧠 Dynamic CLI CRUD Generator for Laravel

Dynamic CLI CRUD is a smart, interactive generator for Laravel that creates production-ready CRUD modules (models, controllers, requests, resources, migrations, enums) with automatic schema detection, relations, enums, translatable fields, and file handling.

✨ Key Features

• 🧠 Smart Schema Detection: Detects field types, required fields, unique constraints, enums, file uploads, and relations automatically.
• 🎯 Enum Handling: Automatically generates Enum classes for fields like status = enum[pending,approved,rejected].
• 🌍 Translatable Fields: Detects multilingual fields (ar, en, etc.) and stores them in JSON columns.
• 🔗 Relations Awareness: Detects belongsTo foreign keys (e.g., country_id) and sets up metadata for CRUD.
• 🖼️ File Uploads: Supports file fields (file, image, etc.) with category and allowed file types.
• ⚡ Interactive CLI: Step-by-step guidance for CRUD generation.
• 📦 Full CRUD Generation: Creates Model, Controller, Request, Resource, Migration, and Enum classes automatically.
• 💪 Force Overwrite: Re-generate existing files safely using --force.
• 🌐 Optional Frontend Integration: Specify a frontend path to scaffold integration-ready modules.
• 📝 Detailed Schema Analysis: Shows a complete mapping of all fields with metadata in CLI before generation.

📦 Installation

Install via Composer:

✅ Auto-discovers the service provider. No manual registration needed.

⚡ Quick Start

Generate a CRUD module interactively:

Or provide the name directly and force overwrite if needed:

🔹 Example CLI Flow

🔹 JSON Schema Example

🔹 Final Schema Mapping (CLI Output)

🏗 CRUD File Generation

After confirmation, the generator creates:

Next steps:

🔹 Advanced Features

Enum Handling 🎯

• Automatically generates Enum classes for any field defined as enum[...].
• Enum classes include a static resolve($value) method for easy mapping.

Translatable Fields 🌍

• Detects JSON structures with language keys (ar, en).
• Stores translations in JSON column for multilingual support.

Relations Detection 🔗

• Detects fields ending with _id or typed as foreignId.

• Prepares metadata for belongsTo relationships automatically.

• Generates relation info for controller, resource, and request.

File Uploads 🖼️

• Supports file fields (file, image, pdf, docx).
• Detects category and allowed file types.
• Integrates with Laravel file handling in requests.

CLI Options & Metadata

• Force: --force to overwrite existing files.
• Group: Organize CRUD modules by logical group (e.g., DataEntry).
• Table Name: Auto-generated from model name but customizable.
• Route: Default api, can be extended to web.

🔧 Optional Frontend Integration

The CLI can scaffold integration-ready modules for your frontend:

🤝 Contribution

1. Fork the repository

2. Create a feature branch:

3. Commit your changes:

4. Push the branch:

5. Open a pull request

📦 Version Support

• PHP: 8.1 – 8.3
• Laravel: 10.x

📜 License

MIT © Hasan Hawary

🔗 Links

• GitHub: https://github.com/hasanhawary/dynamic-cli
• Packagist: https://packagist.org/packages/hasanhawary/dynamic-cli