PHPackages                             minilara/minilara - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database &amp; ORM](/categories/database)
4. /
5. minilara/minilara

ActiveProject[Database &amp; ORM](/categories/database)

minilara/minilara
=================

Mini Lara Industrial - Ultra-lightweight, 7-file core PHP framework with Laravel 13 components, automated migrations, and high-contrast ledger printing.

1.4.0(3w ago)129↓100%MITBladePHP ^8.3

Since May 16Pushed 3w agoCompare

[ Source](https://github.com/softdevhassan/minilara)[ Packagist](https://packagist.org/packages/minilara/minilara)[ RSS](/packages/minilara-minilara/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (13)Versions (2)Used By (0)

MiniLara Industrial
===================

[](#minilara-industrial)

[![Latest Version](https://camo.githubusercontent.com/fddd9214e07c4966f17af54b1bc55c62fcd6b70d466ebe2bb275204f18ec066e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d696e696c6172612f6d696e696c6172612e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/minilara/minilara)[![PHP Version](https://camo.githubusercontent.com/aa5173f35ff61eb70850b202e6ba4aca7d743ee098898e6ccf6338f2aed642dd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e332532422d626c75652e7376673f7374796c653d666c61742d737175617265)](https://php.net)[![License: MIT](https://camo.githubusercontent.com/458425f8985b0b0c8a736cffe75e05a098e3d77906acddbcad2bfc54492a4e02/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Total Downloads](https://camo.githubusercontent.com/fd773bf9c5a01937420a0b64152bbfa3aeeba68ec8afd758a6050243d2d4ca99/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d696e696c6172612f6d696e696c6172612e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/minilara/minilara)

**Ultra-lightweight PHP 8.3 framework with a 7-file core, powered by real Laravel 13 Illuminate components.**

Built for industrial-grade business systems — ERP, CRM, ledger, and internal tooling — where you need Eloquent ORM, Blade templating, and Laravel Validation without the full Laravel overhead.

---

Why MiniLara?
-------------

[](#why-minilara)

Most PHP micro-frameworks strip out the ecosystem you actually need. MiniLara keeps it. You get Eloquent ORM, Blade templating, Laravel Validation, and Symfony HTTP Foundation — all wired into a transparent 7-file core you can read and understand in under an hour.

FeatureMiniLaraRaw LaravelOther Micro-FrameworksLaravel Illuminate componentsYesYesNo7-file core architectureYesNoYesCLI migration engineYesYesNoPWA support built-inYesNoNoTailwind CSS 4 + Alpine.jsYesOptionalNoIndustrial ledger printingYesNoNo---

Quick Start
-----------

[](#quick-start)

```
composer create-project minilara/minilara your-app-name
cd your-app-name
cp .env.example .env
php ml run
```

Open `http://localhost:8000` and log in at `/auth/login` with the default credentials below.

---

Requirements
------------

[](#requirements)

- PHP 8.3 or higher
- Composer 2+
- Node.js and pnpm (for frontend asset compilation)
- MySQL, SQLite, or PostgreSQL

---

Tech Stack
----------

[](#tech-stack)

LayerPackageRoutingnikic/fast-routeHTTPsymfony/http-foundationORMilluminate/database (Eloquent)Templatingilluminate/view (Blade)Validationilluminate/validationEventsilluminate/eventsFilesystemilluminate/filesystemTranslationsilluminate/translationLoggingmonolog/monologDatesnesbot/carbonCLIsymfony/consoleEnvironmentvlucas/phpdotenvFrontendTailwind CSS 4, Alpine.js, jQuery 4Build ToolVite---

CLI Commands
------------

[](#cli-commands)

MiniLara ships with a CLI tool called `ml`. Run all commands from the project root.

```
# Database
php ml migrate                        # Run all pending migrations
php ml migrate --fresh                # Wipe the database and re-run all migrations
php ml make:migration create_users    # Create a new version-controlled migration file
php ml db:seed                        # Run all database seeders

# Security
php ml gen-keys                       # Generate secure encryption keys for .env

# Development
php ml run                            # Start the built-in PHP development server
```

---

Project Structure
-----------------

[](#project-structure)

```
minilara/
|
|-- app/
|   |
|   |-- api/                              # Lightweight JSON API endpoints
|   |   `-- search.php                    # Global search endpoint
|   |
|   |-- config/                           # Application configuration files
|   |   |-- modules.php                   # Module registration and settings
|   |   `-- permissions.php               # Role and permission definitions
|   |
|   |-- core/                             # Framework kernel (7-file core)
|   |   |-- Console.php                   # CLI command dispatcher
|   |   |-- DB.php                        # Eloquent connection bootstrapper
|   |   |-- DevTool.php                   # Development utilities and debugging
|   |   |-- Framework.php                 # Application container and bootstrapper
|   |   |-- Installer.php                 # First-run installation handler
|   |   |-- Router.php                    # Route dispatcher (wraps nikic/fast-route)
|   |   `-- functions.php                 # Global helper functions
|   |
|   |-- database/
|   |   |-- migrations/                   # Version-controlled schema files
|   |   |   |-- 2023_01_01_000001_create_users_table.php
|   |   |   `-- 2023_01_01_000002_create_settings_table.php
|   |   `-- seeds/                        # Database seeders
|   |       `-- AdminUserSeeder.php       # Creates the default admin user
|   |
|   |-- lang/                             # Translation files
|   |   `-- en/
|   |       `-- validation.php            # English validation messages
|   |
|   |-- public/                           # Publicly served static assets
|   |   |-- images/
|   |   |   |-- default-avatar.webp
|   |   |   |-- favicon.ico
|   |   |   |-- pwa-icon-192.png
|   |   |   `-- pwa-icon.png
|   |   |-- manifest.json                 # PWA web manifest
|   |   `-- sw.js                         # PWA service worker (offline support)
|   |
|   `-- src/                              # Frontend source files (compiled by Vite)
|       |-- assets/
|       |   |-- css/
|       |   |   `-- app.css               # Tailwind CSS 4 entry point
|       |   `-- js/
|       |       `-- app.js                # Alpine.js + jQuery entry point
|       |
|       |-- layout/                       # Shared Blade layout components
|       |   |-- app.blade.php             # Base application layout
|       |   |-- breadcrumbs.blade.php     # Breadcrumb navigation component
|       |   `-- navbar.json               # Navigation menu configuration
|       |
|       `-- pages/                        # Blade page templates
|           |-- auth/
|           |   `-- login.blade.php       # Login page
|           |-- errors/
|           |   |-- 404.blade.php         # 404 Not Found page
|           |   `-- 500.blade.php         # 500 Server Error page
|           |-- main/                     # Core application pages
|           |   |-- home.blade.php        # Dashboard home
|           |   |-- profile.blade.php     # User profile page
|           |   |-- settings.blade.php    # Application settings page
|           |   `-- users.blade.php       # User listing and management
|           |-- manage/
|           |   `-- user.blade.php        # Individual user management
|           `-- prints/                   # Print-ready A4 document templates
|               |-- reports/
|               |   `-- dummy.blade.php   # Report print template
|               `-- single/
|                   `-- dummy.blade.php   # Single-record print template
|
|-- bin/
|   `-- minilara                          # Internal CLI binary
|
|-- .env.example                          # Environment configuration template
|-- .gitignore
|-- .htaccess                             # Apache URL rewrite rules
|-- index.php                             # Front controller (application entry point)
|-- ml                                    # MiniLara CLI tool (run as: php ml )
|-- composer.json                         # PHP dependencies
|-- composer.lock
|-- package.json                          # Frontend dependencies
|-- pnpm-lock.yaml
`-- vite.config.js                        # Vite build configuration

```

---

Core Features
-------------

[](#core-features)

### The 7-File Core (`app/core/`)

[](#the-7-file-core-appcore)

The entire framework kernel lives in seven files. There is no hidden magic, no auto-generated configuration, and no service container you cannot inspect. Each file has a single responsibility:

- `Framework.php` — bootstraps the application, binds services, and handles the request lifecycle
- `Router.php` — dispatches HTTP requests to controllers using nikic/fast-route
- `DB.php` — initializes the Eloquent ORM connection from `.env` configuration
- `Console.php` — registers and dispatches all `php ml` CLI commands
- `Installer.php` — handles first-run setup and environment validation
- `DevTool.php` — provides debugging utilities available in development mode
- `functions.php` — global helpers available throughout the application

### CLI Migration Engine (`app/database/migrations/`)

[](#cli-migration-engine-appdatabasemigrations)

Migrations are prefixed with a timestamp and tracked in the database. The engine applies only pending migrations in version order, with full reset support via `--fresh`.

### PWA Support (`app/public/`)

[](#pwa-support-apppublic)

The `manifest.json` and `sw.js` service worker are included out of the box. The application installs as a native PWA on desktop and mobile with offline capability, using the icon assets in `app/public/images/`.

### Industrial Print Infrastructure (`app/src/pages/prints/`)

[](#industrial-print-infrastructure-appsrcpagesprints)

Print templates are standalone Blade files organized into `reports/` for multi-record documents and `single/` for individual record sheets. They do not inherit the main application layout, giving full control over print styling and A4 formatting.

### Configuration System (`app/config/`)

[](#configuration-system-appconfig)

- `modules.php` — registers application modules and controls which features are active
- `permissions.php` — defines roles and permission maps used by the middleware layer

### API Layer (`app/api/`)

[](#api-layer-appapi)

Lightweight PHP endpoints for AJAX and JSON responses. `search.php` provides the global search feature used by the navigation bar.

---

Built For Industrial Use Cases
------------------------------

[](#built-for-industrial-use-cases)

MiniLara is purpose-built for systems that need speed, database reliability, and full print control — not for public-facing marketing websites.

- **ERP Systems** — Inventory tracking, purchasing workflows, production management
- **CRM Platforms** — Customer records, sales pipelines, contact management
- **Ledger and Accounting** — High-contrast A4 document printing, transaction records
- **Internal Business Tools** — Admin dashboards, reporting systems, operational tools

---

Default Login Credentials
-------------------------

[](#default-login-credentials)

FieldValueURL/auth/loginUsernameadminPasswordadminChange the default credentials immediately before deploying to any non-local environment.

---

Contributing
------------

[](#contributing)

Contributions, bug reports, and pull requests are welcome. Please open an issue first to discuss any significant changes.

---

Author
------

[](#author)

**Hassan Ali** — Lead Developer

---

License
-------

[](#license)

MIT License — free to use for personal and commercial projects.

---

Keywords
--------

[](#keywords)

php micro-framework, laravel boilerplate, php erp framework, eloquent orm lightweight, blade php, php crm, fast-route php, php 8.3 framework, industrial php, composer php boilerplate, tailwind css 4 php, alpine.js php, pwa php framework, php ledger system, php business framework

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance96

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

25d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/731ac992b7a178711ef8640ac3e9135af2e6e4be4e6b35983db4e3ceb3a1c455?d=identicon)[minilara](/maintainers/minilara)

---

Top Contributors

[![softdevhassan](https://avatars.githubusercontent.com/u/128244826?v=4)](https://github.com/softdevhassan "softdevhassan (21 commits)")

---

Tags

alpinejsbladeboilerplatecomposercrmeloquenterpfast-routingindustriallaravellightweightmicro-framworkmigrationsphpphp-frameworkphp8pwarest-apitailwindcssvitefast-routephp frameworkalpinejstailwind-4laravel-13erp boilerplatecrm frameworkbusiness management systemmini lara

### Embed Badge

![Health badge](/badges/minilara-minilara/health.svg)

```
[![Health](https://phpackages.com/badges/minilara-minilara/health.svg)](https://phpackages.com/packages/minilara-minilara)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[laravel/framework

The Laravel Framework.

34.7k532.1M19.2k](/packages/laravel-framework)[flarum/core

Delightfully simple forum software.

261.4M2.2k](/packages/flarum-core)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45344.0k1](/packages/pressbooks-pressbooks)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9732.3M121](/packages/roots-acorn)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
