Modular ERP System
Built with Laravel 12 · Filament 3 · Tailwind CSS
EasyERP is a modular Enterprise Resource Planning system designed for flexibility. Each business domain lives in its own module using nwidart/laravel-modules, making it easy to enable, disable, or extend functionality as needed.
| Module | Description | Status |
|---|---|---|
| HumanResource | Employee management, attendance, payroll | ✅ Production-ready |
| Accounting | Financial accounting & reporting | 🔧 In progress |
| Email integration & management | 🔧 In progress | |
| Inventory | Stock & warehouse management | 🔧 In progress |
| Marketing | Campaigns & lead tracking | 🔧 In progress |
| Profile | User profile & settings | 🔧 In progress |
| Purchasing | Purchase orders & vendor management | 🔧 In progress |
| Recruitment | Applicant tracking & hiring | 🔧 In progress |
| Web | Public-facing website | 🔧 In progress |
- Record Rules — Per-module access control & record-level permissions (not yet implemented)
- Stabilize remaining modules to production quality
- Comprehensive test coverage across all modules
Note: Only HumanResource is considered complete. Other modules are functional but still under active development. Expect breaking changes.
| Layer | Technology |
|---|---|
| Backend | PHP 8.3+, Laravel 12 |
| Admin Panel | Filament 3 |
| Frontend | Livewire, Alpine.js, Tailwind CSS |
| Build | Vite |
| Database | PostgreSQL 16+ (well-tested) |
| Queue | Database driver |
| Caching | Database / Redis |
- PHP >= 8.2 (with
ext-openssl,ext-zip) - Node.js >= 18
- Composer 2
- PostgreSQL 16+ (recommended, well-tested)
git clone https://github.com/brainplusplus/easyerp.git
cd easyerp
# PHP dependencies
composer install
# Node dependencies
npm installcp .env.example .env
php artisan key:generateEdit .env — configure your database credentials:
DB_CONNECTION=pgsqlDB_HOST=127.0.0.1DB_PORT=5432DB_DATABASE=easyerpDB_USERNAME=postgresDB_PASSWORD=secretphp artisan migrate
npm run buildcomposer devThis starts the dev server, queue worker, log tail, and Vite HMR concurrently.
# Development server (all services)
composer dev
# Build production assets
npm run build
# Run tests
composer test# Module management
php artisan module:make ModuleName # Create new module
php artisan module:enable ModuleName # Enable module
php artisan module:disable ModuleName # Disable module
php artisan module:list # List all moduleseasyerp/
├── app/ # Core application (Models, Providers, etc.)
├── config/ # Laravel configuration
├── database/ # Migrations, seeders, factories
├── Modules/ # Business domain modules
│ ├── Accounting/
│ │ ├── app/ # Module models, Filament resources, services
│ │ ├── database/ # Module migrations & seeders
│ │ ├── resources/ # Module views & assets
│ │ └── routes/ # Module routes
│ ├── HumanResource/
│ ├── Inventory/
│ ├── Purchasing/
│ └── .../
├── public/ # Web root
├── resources/ # Global views, CSS, JS
├── routes/ # Global route definitions
└── tests/ # Test suites
Each module follows the same internal structure and is self-contained with its own models, migrations, routes, and Filament resources.
Proprietary. All rights reserved.