Open-Source Enterprise Resource Planning for Modern Businesses

Built with Laravel 11 • Powered by FilamentPHP 4 • PHP 8.2+

1. Introduction
2. Key Features
3. Why Choose Aureus ERP?
4. Requirements
5. Quick Start
6. Plugin System
7. Plugin Installation & Management
8. Customization
9. Contributing
10. License
11. Security
12. Support & Community

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 4, 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.

• 🏗️ Modern Architecture: Built with Laravel 11 and FilamentPHP 4 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 3 integration for dynamic interfaces

Ensure your development environment meets the following requirements:

• PHP: 8.2 or higher
• Database: MySQL 8.0+ or SQLite 3.8.3+
• Web Server: Apache 2.4+ or Nginx 1.18+

• Composer: Latest version (2.0+)
• Node.js: 18.x or higher
• NPM/Yarn: Latest stable version

• Laravel: 11.x
• FilamentPHP: 4.x
• Livewire: 3.x
• TailwindCSS: 4.x

Get Aureus ERP up and running in just 4 simple steps:

git clone https://github.com/aureuserp/aureuserp.git
cd aureuserp

composer install

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

php artisan serve

Visit http://localhost:8000 and log in with your admin credentials!

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.

These plugins are essential components of the system and are installed by default:

These plugins can be installed as needed to extend system functionality:

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

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.

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

AureusERP is designed to be highly customizable, allowing you to tailor the system to your specific business needs:

• 🔹 Install only the plugins you need
• 🔹 Extend existing plugins with custom functionality
• 🔹 Create custom plugins using the modular architecture

• 🔹 Create custom dashboards and reports
• 🔹 Modify themes and branding
• 🔹 Design custom forms and views with Filament

• 🔹 Define custom user roles and permissions
• 🔹 Configure role-based access control (RBAC)
• 🔹 Set granular permissions using Filament Shield

• 🔹 Extend models with custom business rules
• 🔹 Create custom workflows and automations
• 🔹 Integrate with third-party services via APIs

We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.

1. Fork the Repository

   git clone https://github.com/aureuserp/aureuserp.git

2. Create a Feature Branch

   git checkout -b feature/your-feature-name

3. Make Your Changes

   • Follow the existing code style and conventions
   • Write tests for new features
   • Update documentation as needed

4. Commit Your Changes

   git commit -m "Add: Brief description of your changes"

5. Push to Your Fork

   git push origin feature/your-feature-name

6. Submit a Pull Request

   • Provide a clear description of the changes
   • Reference any related issues
   • Ensure all tests pass

• Follow Laravel and Filament best practices
• Maintain code quality with Laravel Pint: vendor/bin/pint
• Write PHPUnit tests for new functionality
• Use meaningful commit messages

AureusERP is truly open-source ERP framework that will always be free under the MIT License.

• ✅ Free to use for commercial and personal projects
• ✅ Modify and distribute as you wish
• ✅ No licensing fees or restrictions
• ✅ Community-driven development

Security is a top priority for AureusERP. We take all security vulnerabilities seriously.

⚠️ Please DO NOT disclose security vulnerabilities publicly.

If you discover a security vulnerability in AureusERP, please report it responsibly:

📧 Email: [email protected]

• Description of the vulnerability
• Steps to reproduce the issue
• Potential impact assessment
• Suggested fix (if available)

We will acknowledge your email within 48 hours and provide a detailed response within 7 days, including our assessment and a timeline for a fix.

Need help or want to connect with other AureusERP users?

• 📖 Developer Documentation: devdocs.aureuserp.com - Technical guides, API references, and development resources
• 📘 User Guide: docs.aureuserp.com - Step-by-step tutorials and user manuals

• 💬 Community Forum: [Coming Soon] - Connect with other users and share experiences
• 🐛 Issue Tracker: GitHub Issues - Report bugs and request features
• 📧 Email Support: [email protected] - Direct support from the team

• ⭐ Star this repository to show your support
• 👁️ Watch for new releases and updates
• 🍴 Fork to contribute to the project