raza9798 / laravel-core-modules
Laravel package for modular development, providing a structured approach to organizing models, controllers, migrations, and policies under a clean namespace like Core/. It simplifies scaffolding and enhances code separation for improved project structure.
1.0.1
2026-07-15 17:17 UTC
Requires
- php: ^8.2|^8.3
- illuminate/support: ^12.0|^13.0
README
laravel-core-modules package.
๐ฆ Laravel Core Modules
A lightweight Laravel package to generate and manage modular application structure using Artisan-based scaffolding.
It helps you organize Laravel applications into feature-based modules containing:
- Controllers
- Models
- Migrations
- Seeders
- Factories
- Requests
- Policies
๐ Installation
1. Install via Composer
$ composer require raza9798/laravel-core-modules $ php artisan core-modules:install
2. Register Service Provider (if auto-discovery is disabled)
// config/app.php 'providers' => [ Raza9798\LaravelCoreModules\CoreModulesServiceProvider::class, ],
3. Setup Modules Autoload (IMPORTANT)
Add this to your Laravel application's composer.json:
"autoload": { "psr-4": { "App\\": "app/", "Modules\\": "Modules/" } }
Then run:
composer dump-autoload
โ๏ธ Configuration (Optional)
Publish config file:
php artisan vendor:publish --tag=laravel-core-modules-config
๐ Default Module Structure
When a module is created:
Modules/
โโโ Inventory/
โโโ app/
โ โโโ Http/
โ โ โโโ Controllers/
โ โโโ Models/
โ โโโ Policies/
โโโ database/
โ โโโ migrations/
โ โโโ seeders/
โ โโโ factories/
โโโ routes/
โโโ tests/
โ โโโ Feature/
โ โโโ Unit/
๐งโ๐ป Available Commands
๐ Create Module
php artisan module:create {name}
Example:
php artisan module:create Inventory
๐ Generate Module Files
php artisan module:make
Flow:
- Select existing module OR create new one
- Select artifact preset
- Generate required files
๐ Artifact Options
When running module:make:
Select artifacts to generate:
โ API Resource
โ Database
โ Custom
API Resource generates:
- Controller
- Model
- Migration
- Seeder
- Factory
Database generates:
- Model
- Migration
- Seeder
- Factory
Custom generates:
- Controller
- Model
- Migration
- Seeder
- Factory
- (More coming)
๐งช Example Usage
Step 1: Create a module
php artisan module:create Inventory
Step 2: Generate files inside module
php artisan module:make
Example flow:
Select module:
> Inventory
Select artifacts:
> API Resource
Enter name:
> ItemMaster
Result:
Modules/Inventory/
โโโ app/Http/Controllers/ItemMasterController.php
โโโ app/Models/ItemMaster.php
โโโ database/migrations/...
โโโ database/seeders/...
โ ๏ธ Important Notes
- Requires PSR-4 autoloading for
Modules\namespace - Run
composer dump-autoloadafter setup - Laravel base controller may be used inside modules
Artisan Commands Summary
php artisan module -h
๐ค Contributing
Feel free to fork and improve the package.
๐ License
MIT License ยฉ Raza9798