Skip to content
 
 

Repository files navigation

LiteERP Logo

LiteERP

Lightweight Open-Source ERP for internal business operations.


LiteERP Screenshot

LiteERP Screenshot


🎯 Who Is LiteERP Built For?

LiteERP is designed for small and medium-sized businesses (SMEs) that need a clean, operational ERP core without enterprise-level complexity.

Typical use cases include:

  • Retail stores and retail chains
  • Wholesale distributors
  • Trading companies
  • Import / export businesses
  • SMEs managing inventory, orders, pricing, and customers

LiteERP focuses on day-to-day internal operations, such as:

  • Product & inventory management
  • Purchase & sales workflows
  • Pricing rules and discounts
  • Customer & supplier management

Industry-specific requirements — such as reporting, analytics, tax rules, accounting integration, custom pricing logic, or workflow automation — are intentionally handled through Extensions, not hardcoded into the core.


🏢 LiteERP – A Pure Core ERP, Built for Extension, Not Complexity

LiteERP is an open-source ERP built with Laravel, ReactJS, and MySQL 8,
designed as a pure, minimal core with an extension-first architecture.

LiteERP is not trying to replace SAP or Odoo.
Those platforms are powerful and suitable for large enterprises or broad use cases.

LiteERP follows a different philosophy:

Keep the core small, stable, and predictable —
push complexity outward into extensions.

The system is built on:

  • Clean Architecture
  • Domain-Driven Design (DDD)
  • Domain Events
  • Very low framework coupling

⚖️ LiteERP vs Odoo vs SAP

Aspect LiteERP Odoo SAP
Core size Small & pure Large, feature-heavy Very large
Customization Extensions & hooks Core overrides & modules Consultants & customization layers
Infrastructure Low-resource friendly Medium–High High–Very High
Upgrade safety High Medium Low–Medium
Target users SMEs & developers SMEs–Enterprises Large enterprises

🧠 A Pure and Minimal Core

The LiteERP core intentionally focuses only on:

  • Essential operational workflows
  • Clear and predictable business rules
  • Strong domain boundaries
  • Authentication & authorization
  • Multi-business context
  • Extension loading mechanism

Instead of absorbing complexity,
LiteERP treats complexity as an external concern handled by extensions.


🧩 Extensions – Where Real Power Lives

All domain-specific and evolving business logic lives in Extensions.

Extensions are:

  • Fully decoupled from the core
  • Loaded only when needed
  • Able to hook into domain events, validation, workflows, and APIs
  • Safe to develop, replace, or remove without touching core logic

✅ Production-ready Extensions

  • HRM Extension – time attendance, leave management
  • SMTP Extension – system-wide email configuration
  • Debt Extension – basic debt & receivable tracking

📚 Example & Guide Extensions

https://github.com/liteerp-oss/liteerp/tree/dev/extension-examples


🎨 Hybrid Frontend Architecture (React + Blade)

LiteERP uses a Hybrid Frontend Architecture, giving each Extension full freedom to choose the most suitable UI approach.

An Extension can:

  • 🧱 Use Blade Templates
  • ⚛️ Use ReactJS
  • 🖥️ Build a fully independent dashboard

🌐 Multi-language Support

Supported languages:

  • 🇺🇸 English
  • 🇯🇵 Japanese
  • 🇻🇳 Vietnamese

Each Extension manages its own translations.


📉 Lightweight by Design

LiteERP focuses on operations, not accounting or tax compliance.

LiteERP invoices are operational invoices,
not replacements for accounting or government e-invoicing systems.


❌ What LiteERP Is NOT

  • ❌ Accounting software
  • ❌ Tax-compliant invoicing system
  • ❌ Government e-invoice platform

🛠 Technologies Used

  • Laravel 12
  • ReactJS
  • MySQL 8
  • PHP 8.3+
  • Clean Architecture
  • Domain Driven Design
  • Domain Events

🧪 Testing & Quality

  • Unit tests
  • Global testing
  • Clean code standards

📦 Documentation

https://github.com/liteerp-oss/liteerp/tree/dev/docs


🧭 Roadmap

  • Extension standards & best practices
  • Expanded documentation
  • Extension marketplace concept

🤖 AI Agent Extensions (Planned)

LiteERP plans to introduce AI Agent Extensions as optional, fully decoupled extensions designed to assist businesses, not replace human decision-making.

AI agents will:

  • Live entirely outside the core
  • Subscribe to domain events and APIs
  • Provide insights, recommendations, and explanations
  • Be optional, replaceable, and safe to disable
  • Support self-hosted or external AI providers

Example AI agent concepts:

  • Operations insight & anomaly detection
  • Sales and purchasing recommendations
  • Natural language business queries (internal Q&A)
  • Workflow observation and optimization suggestions

LiteERP treats AI as an extension-level concern, fully aligned with its pure-core and extension-first philosophy.


🐳 Docker Setup (Quick Start)

Basic environment configuration:

APP_TIMEZONE="Asia/Ho_Chi_Minh"
APP_CURRENCY="USD"
APP_CURRENCY_LOCALE="en-US"

Steps:

  1. docker compose build && docker compose up -d
  2. docker exec -it LiteERP-app bash
  3. composer install
  4. php artisan app:setup
  5. php artisan app:create-admin {email} {password} {name}

Visit:
http://localhost:8002/dashboard/login


👨‍💻 Author

Stevelee

📄 Contact

📧 hoang.le.tn91@gmail.com

💬 Community

Discord:
https://discord.gg/VExDJ7k8


❤️ Support LiteERP

If LiteERP helps you:

  • Give the project a ⭐
  • Share feedback
  • Contribute extensions or ideas

About

LiteERP – Lightweight and flexible ERP for small businesses. Laravel, Reactjs for ERP. Clean Architecture, Domain driven design... Turbocharged like an F1 car.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages