nasirkhan/module-manager

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

Migration Management

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

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

Image previews on edit forms

The Post, Category, and Tag module edit forms display a thumbnail of the currently saved image alongside the file input. When an image is attached, the form renders a PhotoSwipe-compatible gallery block that opens the full-size image in an overlay on click:

<div class="pswp-gallery">
    <figure>
        <a href="https://github.com/nasirkhan/module-manager/blob/HEAD/storage/posts/photo.jpg" data-pswp-src="/storage/posts/photo.jpg">
            <img src="https://raw.githubusercontent.com/nasirkhan/module-manager/HEAD/storage/posts/photo-thumb300.jpg" class="rounded img-thumbnail" alt="" />
        </a>
    </figure>
</div>

This markup is output by each module's form.blade.php partial. PhotoSwipe itself is initialised by the host application — Laravel Starter does this automatically in resources/js/photoswipe.js. If you use these modules in a custom host application, ensure PhotoSwipe is installed (npm install photoswipe) and initialised for any .pswp-gallery element.