Download the PHP package libinkk/modular without Composer

libinkk/modular

The easiest way to build scalable Laravel applications using Modular Architecture.

libinkk/modular is an opinionated Laravel package that helps developers build large, maintainable, and scalable applications using a modular architecture with zero manual configuration.

Instead of manually creating folders, registering service providers, loading routes, migrations, views, and configurations, libinkk/modular automates the entire workflow.

Vision

Build enterprise-level Laravel applications without worrying about project structure.

Our goal is to provide:

• Zero configuration
• Opinionated architecture
• Automatic discovery
• Production-ready code generation
• Excellent developer experience

Why libinkk/modular?

As Laravel projects grow, maintaining a clean architecture becomes difficult.

Common problems include:

• Different folder structures across projects
• Manual Service Provider registration
• Manual route loading
• Manual migration loading
• Poor code organization
• Large controllers
• Mixed business logic
• Difficult project maintenance
• Slow onboarding for new developers

libinkk/modular solves these problems by enforcing a clean modular architecture.

Features

• Modular Architecture
• Automatic Module Discovery
• Automatic Service Provider Registration
• Automatic Route Discovery
• Automatic Migration Discovery
• Automatic View Discovery
• Automatic Translation Discovery
• Automatic Configuration Loading
• Repository Pattern Support
• Service Layer Support
• DTO Support
• Action Classes
• Event & Listener Support
• Job Support
• Policy Support
• Notification Support
• Testing Support
• CRUD Generator
• Module Cache
• Module Enable/Disable
• Module Dependency Management

Installation

modular:install creates the Modules folder, publishes config, and generates the module cache. It does not edit composer.json.

Add PSR-4 to your app composer.json yourself:

Then:

Folder Structure

Module Structure

Each module is completely isolated.

Creating a Module

This command generates Modules/User/ including:

• Provider
• Routes
• Config
• Database
• Views
• Language
• Tests
• module.json

Module Configuration

Every module contains a module.json.

This file manages:

• Module name
• Version
• Description
• Enable/Disable status
• Dependencies

Automatic Discovery

Module Discovery

During application boot, the package automatically:

1. Scans the Modules directory
2. Finds every module.json
3. Ignores disabled modules
4. Loads Service Providers
5. Registers everything automatically

No manual registration is required.

Service Provider Registration

Each module contains Providers/UserServiceProvider.php. The package registers every provider automatically.

Developers never need to edit:

• bootstrap/providers.php
• config/app.php

Route Discovery

The package automatically loads:

• Modules/*/Routes/web.php
• Modules/*/Routes/api.php

No RouteServiceProvider modifications are required.

Migration Discovery

Every migration inside Modules/*/Database/Migrations runs automatically:

View Discovery

Views inside Modules/User/Views can be used like:

Translation Discovery

Language files inside Modules/User/Lang can be accessed using:

Command Syntax

The package supports multiple command styles. All three generate the same result:

Nested Folder Support

Output:

Namespaces are generated automatically.

Available Commands

Repository Generator

Automatically generates:

• Repository
• Interface
• Service Provider Binding
• Matching service (create with DI, or smart-merge into an existing service)
• Controller constructor wiring when a matching controller already exists

Use --no-inject to skip sibling wiring without asking (still creates a missing paired service). Use --inject to wire without asking.

Auto dependency injection

Wiring is naming-convention based and smart-merges constructor DI without wiping custom methods.

CRUD Generator

Generate an entire CRUD module with one command:

Automatically creates:

• Model
• Migration
• Factory
• Seeder
• Repository
• Repository Interface
• DTO
• Actions
• Service
• Controller
• Form Requests
• API Resource
• Policy
• Routes
• Feature Tests

Repository Pattern

The package automatically binds interfaces. Instead of manually writing:

everything is generated automatically.

Module Management

Enable / Disable

No code deletion is required.

List Modules

Rename Module

Automatically updates:

• Folder names
• Namespaces
• Providers
• Configuration
• References

Delete Module

Safely removes the module after confirmation.

Module Cache

Caching avoids scanning every module on each request and improves production performance.

Module Dependencies

If a dependency is missing, the package reports an error before booting the application.

Recommended Architecture

Business logic should never exist inside controllers.

Developer Workflow

Traditional Laravel

With libinkk/modular

Future Roadmap

Version 1.0

• Module Generator
• Automatic Discovery
• Code Generators
• CRUD Generator

Version 1.5

• Repository Automation
• Service Automation
• Module Cache

Version 2.0

• Dependency Management
• Architecture Analyzer
• Project Health Checker

Version 3.0

• AI-assisted Scaffold Generator
• OpenAPI Documentation Generator
• Module Dependency Graph
• Multi-Tenant Support

Philosophy

A Laravel application should be organized by business modules, not by framework folders.

Every feature should be self-contained.

Every module should be:

• Independent
• Testable
• Maintainable
• Scalable
• Reusable

Goal

Install once. Generate modules. Focus only on business logic.

Everything else should be handled automatically by libinkk/modular.