PHPackages                             elyerr/elymod - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. elyerr/elymod

ActiveProject[Utility &amp; Helpers](/categories/utility)

elyerr/elymod
=============

Elymod module project template

v3.0.2(1w ago)0771MITVue

Since Dec 27Pushed 3w agoCompare

[ Source](https://github.com/elyerrlabs/elymod)[ Packagist](https://packagist.org/packages/elyerr/elymod)[ RSS](/packages/elyerr-elymod/feed)WikiDiscussions dev Synced today

READMEChangelogDependenciesVersions (23)Used By (0)

Elymod
======

[](#elymod)

**Elymod** is a lightweight modular mini-framework inspired by Laravel.

It is designed to build **fully independent third-party modules** that integrate with the **OAuth2 Passport Server ecosystem** while remaining isolated from the core application.

Elymod behaves like a **minimal Laravel runtime**, providing only the features required to develop, test, and distribute modules without depending on a full Laravel application.

---

Compatibility
=============

[](#compatibility)

Elymod is fully compatible with **OAuth2 Passport Server v7 and later (v7+)**.

Starting with OAuth2 Passport Server v7, the host application uses **Vite** as its default asset bundler. However, Elymod maintains support for both **Laravel Mix** and **Vite** when creating and developing third-party modules.

Supported asset drivers:

- Vite (default)
- Laravel Mix (legacy support)

This allows existing modules to continue using Laravel Mix while enabling new modules to adopt Vite.

---

Creating Modules
================

[](#creating-modules)

Modules can be generated directly from OAuth2 Passport Server using the built-in module generator.

### Create a module using Vite (default)

[](#create-a-module-using-vite-default)

```
php artisan module:make UserAccount
```

or explicitly:

```
php artisan module:make UserAccount --driver=vite
```

### Create a module using Laravel Mix

[](#create-a-module-using-laravel-mix)

```
php artisan module:make UserAccount --driver=mix
```

The selected driver determines the frontend build environment and generated project structure.

> Driver selection is available only in **OAuth2 Passport Server v7+**.

---

Supported Drivers
=================

[](#supported-drivers)

Vite (Default)
--------------

[](#vite-default)

Recommended for all new modules.

Features:

- Fast development server
- Hot Module Replacement (HMR)
- Modern ES modules
- Optimized production builds
- Official asset pipeline for OAuth2 Passport Server v7+

### Development

[](#development)

```
npm ci
npm run build
```

---

Laravel Mix
-----------

[](#laravel-mix)

Maintained for backward compatibility.

Features:

- Webpack-based workflow
- Compatible with existing modules
- Legacy asset compilation support
- Migration-friendly environment

### Development

[](#development-1)

```
npm ci
npm run dev
```

> Although Laravel Mix is no longer used by the OAuth2 Passport Server host application, support remains available for third-party modules developed with Elymod.

---

What is Elymod?
===============

[](#what-is-elymod)

Elymod is both:

- 🧩 A mini Laravel runtime for third-party module development
- 🏗️ A modular mini-framework focused on isolation and portability
- 🔐 A foundation for extending OAuth2 Passport Server ecosystems

It allows developers to create modules that feel like Laravel applications while remaining fully decoupled from the core platform.

---

Core Features
=============

[](#core-features)

- 🚀 Powered by `laravel-runtime`
- 📦 Modules behave like standalone Laravel applications
- 🧩 Designed exclusively for third-party modules
- 🛡️ Fail-safe architecture: module failures do not affect the core system
- 🔁 Dynamic loading of:

    - Routes
    - Menus
    - Middleware
    - Rate limits
    - Feature flags
- 🔐 Built for OAuth2 and Passport-based authorization platforms
- 🏗️ Compatible with enterprise modular architectures

---

Laravel Runtime Integration
===========================

[](#laravel-runtime-integration)

Elymod uses **`elyerr/laravel-runtime`** during development to provide:

- Route registration
- Middleware resolution
- View rendering
- Resource generation
- Controller generation
- Request generation
- Policy generation

This provides a familiar Laravel experience while keeping the runtime lightweight.

> Elymod does not require a full Laravel installation in production environments.

---

Dependencies
============

[](#dependencies)

Runtime / Core
--------------

[](#runtime--core)

### `elyerr/api-response`

[](#elyerrapi-response)

Provides a unified response layer for both API and web responses.

### Transformer

[](#transformer)

Required by `api-response` to ensure structured and predictable outputs across modules.

---

Development
-----------

[](#development-2)

### `laravel/framework`

[](#laravelframework)

Used only during local development, testing, and tooling.

### `elyerr/laravel-runtime`

[](#elyerrlaravel-runtime)

Provides Laravel-like functionality without requiring a full Laravel application.

---

Why Elymod?
===========

[](#why-elymod)

Elymod solves common challenges in modular development:

- ❌ Tight coupling to the host application
- ❌ Heavy framework dependencies
- ❌ Fragile upgrades and forks
- ❌ Poor module isolation
- ❌ Difficult long-term maintenance

With Elymod, modules are:

- Independent
- Portable
- Versionable
- Safe to install or remove
- Isolated from core system failures

---

Designed for OAuth2 Passport Server v7+
=======================================

[](#designed-for-oauth2-passport-server-v7)

Elymod is optimized for OAuth2 Passport Server environments where:

- Authentication and authorization remain centralized
- Third-party modules evolve independently
- Security and isolation are mandatory
- Platform upgrades should not break extensions

Each module manages its own:

- Routes
- Views
- Policies
- Middleware
- Configuration
- Frontend assets
- Internal lifecycle

while remaining isolated from the host application.

---

Development Philosophy
======================

[](#development-philosophy)

> The platform owns authentication and authorization. Modules own their business logic.

This separation allows the platform and its extensions to evolve independently while maintaining stability, security, and long-term maintainability.

---

License
=======

[](#license)

MIT License.

Individual modules may define their own licenses and distribution terms.

---

Author
======

[](#author)

**Elvis Yerel Roman Concha**

Email:

---

Ecosystem
=========

[](#ecosystem)

- OAuth2 Passport Server
- Elymod
- Laravel Runtime
- Third-party Elymod Modules

---

Elymod provides a clean, predictable, and Laravel-like environment for building independent modules without compromising platform stability, security, or maintainability.

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance97

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity44

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

Every ~9 days

Total

21

Last Release

10d ago

Major Versions

v1.1.2 → v2.0.02026-06-12

v2.0.0 → v3.0.02026-06-23

### Community

Maintainers

![](https://www.gravatar.com/avatar/966b515d3fb063763019b1950c8c9b4891373924e10f6867420525a726e08217?d=identicon)[elyerr](/maintainers/elyerr)

---

Top Contributors

[![elyerr](https://avatars.githubusercontent.com/u/94133542?v=4)](https://github.com/elyerr "elyerr (54 commits)")

---

Tags

laravelmini-frameworkmodulemodulesoauth2-passport-serveropen-source

### Embed Badge

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

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

###  Alternatives

[prestashop/psgdpr

PrestaShop module psgdpr

326.9M4](/packages/prestashop-psgdpr)[donatj/simplecalendar

A light, easy to use calendar rendering library

8356.7k3](/packages/donatj-simplecalendar)[thedmsgroup/mautic-segment-extras-bundle

Extends Mautic Lead Bundle's Lead List (Segment) functionality.

151.4k](/packages/thedmsgroup-mautic-segment-extras-bundle)

PHPackages © 2026

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