Aureuserp
Free and Open Source ERP platform
Install / Use
/learn @aureuserp/AureuserpREADME
📋 Table of Contents
- Introduction
- Key Features
- Why Choose Aureus ERP?
- Requirements
- Quick Start
- Plugin System
- Plugin Installation & Management
- Customization
- Contributing
- License
- Security
- Support & Community
🚀 Introduction
Aureus ERP is a comprehensive, open-source Enterprise Resource Planning (ERP) solution designed for Small and Medium Enterprises (SMEs) and large-scale organizations. Built on Laravel 11, the most popular PHP framework, and FilamentPHP 5, a cutting-edge admin panel framework, Aureus ERP offers an extensible and developer-friendly platform for managing every aspect of your business operations.
Whether you're managing accounting, inventory, HR, CRM, or projects, Aureus ERP provides a modular approach that grows with your business.
✨ Key Features
- 🏗️ Modern Architecture: Built with Laravel 11 and FilamentPHP 5 for maximum performance and developer experience
- 🧩 Modular Plugin System: Install only the features you need - from accounting to project management
- 🎨 Beautiful UI/UX: Responsive design with TailwindCSS 4, optimized for desktop and mobile
- 🔐 Advanced Security: Role-based access control with Filament Shield integration
- 📊 Business Intelligence: Built-in analytics and reporting tools
- 🌐 Multi-Language Support: Easily translate and localize for global businesses
- ⚡ High Performance: Optimized database queries and caching strategies
- 🔧 Developer-Friendly: Clean code, comprehensive documentation, and extensive APIs
- 🔄 Real-Time Updates: LiveWire 4 integration for dynamic interfaces
🎯 Why Choose Aureus ERP?
| Feature | Benefit | |---------|---------| | Open Source | Free to use, modify, and extend. No vendor lock-in | | Modern Stack | Latest Laravel & FilamentPHP for cutting-edge features | | Scalable | Handles everything from startups to enterprise operations | | Customizable | Extend with your own plugins and modifications | | Community-Driven | Active community support and continuous improvements | | Production-Ready | Battle-tested with real-world business requirements |
📦 Requirements
Ensure your development environment meets the following requirements:
Server Requirements
- PHP: 8.3 or higher
- Database: MySQL 8.0+ or SQLite 3.8.3+
- Web Server: Apache 2.4+ or Nginx 1.18+
Development Tools
- Composer: Latest version (2.0+)
- Node.js: 18.x or higher
- NPM/Yarn: Latest stable version
Framework Versions
- Laravel: 11.x
- FilamentPHP: 5.x
- Livewire: 4.x
- TailwindCSS: 4.x
⚡ Quick Start
Get Aureus ERP up and running in just 4 simple steps:
Step 1: Clone the Repository
git clone https://github.com/aureuserp/aureuserp.git
cd aureuserp
Step 2: Install Dependencies
composer install
Step 3: Run the Installation
php artisan erp:install
What happens during installation:
✅ Database migrations are executed
✅ Core seeders populate initial data
✅ Roles & permissions are generated (via Filament Shield)
✅ Admin account is created
✅ Environment configuration is set up
Step 4: Start the Development Server
php artisan serve
Visit http://localhost:8000 and log in with your admin credentials!
🧩 Plugin System
AureusERP features a powerful modular plugin system that allows you to customize your ERP installation based on your business needs. Choose only the modules you need to keep your system lean and efficient.
📦 Core Plugins (System Plugins)
These plugins are essential components of the system and are installed by default:
| Module | Description | | ---------- | ------------------------------------------------- | | Analytics | Business intelligence and reporting tools | | Chatter | Internal communication and collaboration platform | | Fields | Customizable data structure management | | Security | Role-based access control and authentication | | Support | Help desk and documentation | | Table View | Customizable data presentation framework |
⚡ Installable Plugins
These plugins can be installed as needed to extend system functionality:
💼 Financial Management
| Module | Description | | ---------- | ------------------------------------- | | Accounting | Financial accounting and reporting | | Accounts | Core accounting operations | | Invoices | Invoice generation and management | | Payments | Payment processing and tracking |
📦 Operations
| Module | Description | | ----------- | ----------------------------------------- | | Inventories | Inventory and warehouse management | | Products | Product catalog and management | | Purchases | Procurement and purchase order management | | Sales | Sales pipeline and opportunity management |
👥 Human Resources
| Module | Description | | ------------ | --------------------------------- | | Employees | Employee management | | Recruitments | Applicant tracking and hiring | | Timeoffs | Leave management and tracking | | Timesheet | Employee work hour tracking |
🤝 Customer & Partner Management
| Module | Description | | -------- | -------------------------------------------- | | Contacts | Contact management for customers and vendors | | Partners | Partner relationship management |
📊 Project & Content Management
| Module | Description | | -------- | ------------------------------- | | Blogs | Content management and blogging | | Projects | Project planning and management | | Website | Customer-facing website module |
🔧 Plugin Installation & Management
Installing a Plugin
To install a plugin, use the following Artisan command:
php artisan <plugin-name>:install
Example: Install the Inventories plugin
php artisan inventories:install
During installation, the system automatically checks for dependencies. If dependencies are detected, you'll see:
This package products is already installed. What would you like to do? [Skip]:
[0] Reseed
[1] Skip
[2] Show Seeders
Options:
- Reseed: Reinstall the plugin's seed data (overwrites existing data)
- Skip: Continue without modifying the already installed dependency
- Show Seeders: Display available data seeders for the plugin
Uninstalling a Plugin
To remove a plugin from your system:
php artisan <plugin-name>:uninstall
Example: Uninstall the Inventories plugin
php artisan inventories:uninstall
⚠️ Warning: Uninstalling a plugin will remove its database tables and data. Make sure to backup your data before uninstalling.
Plugin Dependencies
Some plugins require other plugins to function properly. The installation system:
- ✅ Automatically detects dependencies
- ✅ Prompts you to install required plugins
- ✅ Prevents conflicts and missing prerequisites
- ✅ Validates the installation order
🎨 Customization
AureusERP is designed to be highly customizable, allowing you to tailor the system to your specific business needs:
Plugin Customization
- 🔹 Install only the plugins you need
- 🔹 Extend existing plugins with custom functionality
- 🔹 Create custom plugins using the modular architecture
UI/UX Customization
- 🔹 Create custom dashboards and reports
- 🔹 Modify themes and branding
- 🔹 Design custom forms and views with Filament
Access Control
- 🔹 Define custom user roles and permissions
- 🔹 Configure role-based access control (RBAC)
- 🔹 Set granular permissions using Filament Shield
Business Logic
- 🔹 Extend models with custom business rules
- 🔹 Create custom workflows and automations
- 🔹 Integrate with third-party services via APIs
🤝 Contributing
We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.
How to Contribute
- Fork the Repository
git clone https://github.com/aureuserp/aureuserp.git
