Module Manager for Laravel Starter

Module Manager is a powerful module management package for Laravel Starter, providing version tracking, migration management, dependency resolution, and comprehensive module lifecycle management.

Requirements

• PHP ^8.3
• Laravel ^12.0 || ^13.0

📦 Installation

composer require nasirkhan/module-manager

Quick Start

php artisan module:status          # View all modules and their status
php artisan module:dependencies    # Check module dependencies
php artisan migrate                # Run pending migrations

Available Commands

Core

Command	Description
module:status [module]	View module status, versions, and dependencies
module:dependencies [module]	Check dependency satisfaction
module:publish {module}	Publish a module to Modules/ for customization
module:diff {module} [--detailed]	Compare package version with published version
module:enable {module}	Enable a module
module:disable {module}	Disable a module
module:build {module}	Scaffold a new module
module:remove {module}	Remove a module
module:make-test {module} {name} [--unit]	Generate a test class for a module
module:help [topic]	Show command reference and workflows

Migration Management

Command	Description
module:track-migrations [module] [--force]	Record current migration state as baseline
module:detect-updates [module]	Detect new migrations after a composer update
module:check-migrations [module]	Check for unpublished migrations

Module Structure

Modules/Post/
├── module.json
├── Config/
├── Console/
├── database/
│   ├── migrations/
│   ├── seeders/
│   └── factories/
├── Http/
│   ├── Controllers/
│   ├── Requests/
│   └── Middleware/
├── Livewire/
├── Models/
├── Providers/
├── Resources/
├── routes/
├── lang/
├── Tests/
│   ├── Feature/
│   └── Unit/
└── Resources/
    └── views/

---

Module Configuration (module.json)

{
    "name": "Post",
    "alias": "post",
    "description": "Blog post management module with categories, tags, and moderation",
    "version": "1.0.0",
    "keywords": ["post", "blog", "article", "content"],
    "priority": 0,
    "requires": ["Category", "Tag"]
}

• priority: Load order — higher values load first (e.g. 10 for core deps, 5 for UI, 0 for content)
• requires: Module names this module depends on

---

Publishing Module Assets

php artisan vendor:publish --tag=post-migrations
php artisan vendor:publish --tag=post-views
php artisan vendor:publish --tag=post-config
php artisan vendor:publish --tag=post-lang

---

Namespace Architecture

Location	Namespace
vendor/nasirkhan/module-manager/src/Modules/	Nasirkhan\ModuleManager\Modules\{Module}\...
Modules/ (published)	Modules\{Module}\...

When publishing a module (module:publish), all namespaces are rewritten automatically. After publishing, run:

composer dump-autoload
php artisan config:clear

---

Troubleshooting

Module not showing in status:

composer dump-autoload
php artisan cache:clear && php artisan config:clear

Migrations not detected after update:

php artisan module:track-migrations --force
php artisan module:detect-updates
php artisan vendor:publish --tag=post-migrations
php artisan migrate

---

Programmatic API

ModuleVersion

use Nasirkhan\ModuleManager\Services\ModuleVersion;

$service = app(ModuleVersion::class);

$service->getVersion('Post');               // "1.0.0"
$service->getDependencies('Post');          // ['Category', 'Tag']
$service->dependenciesSatisfied('Post');    // bool
$service->getModulesByPriority();           // ordered module list

MigrationTracker

use Nasirkhan\ModuleManager\Services\MigrationTracker;

$tracker = app(MigrationTracker::class);

$tracker->trackModuleMigrations('Post', '1.0.0');
$tracker->getNewMigrationsSinceLastCheck('Post');
$tracker->getPendingMigrations('Post');
$tracker->hasUpdates('Post');

---

Contributing

See CONTRIBUTING.md for development guidelines.

License

MIT License. See LICENSE for details.

Available Modules

Module	Version	Description	Dependencies
Post	1.0.0	Blog post management with moderation	Category, Tag
Category	1.0.0	Category management with nested sets	—
Tag	1.0.0	Polymorphic tagging system	—
Menu	1.0.0	Dynamic menu with nested items	—