GrowERP - Open Source Modular ERP Platform

GrowERP is an open-source, multi-platform ERP application built with a modular architecture that allows for unprecedented extensibility and customization. Whether you're a small business or an enterprise, GrowERP adapts to your needs through its flexible building block system.

🚀 Quick Start

Try GrowERP Now

Production Applications:

• Admin App: Web | Android | iOS
• Hotel App: Web | Android | iOS

Test Next Version:

• Admin: admin.growerp.org
• Hotel: hotel.growerp.org

Create a new company, select demo data, and explore! Login credentials will be sent to your email.

Install Locally (Easy Way)

dart pub global activate growerp
growerp install

📚 Documentation

🏗️ Extensibility & Development

• 📖 Extensibility Overview - Complete guide to GrowERP's modular architecture
• 🧩 Building Blocks Guide - Create Flutter packages (growerp_* packages)
• ⚙️ Backend Components Guide - Develop Moqui components
• 📋 Management Summary - Strategic overview for decision makers

🤝 Contributing

• 🔧 Contributing Guide - How to contribute to GrowERP
• 📜 Code of Conduct - Community guidelines
• 📄 License - CC0 1.0 Universal (Public Domain)

📖 Additional Resources

• User Documentation - End-user guides and tutorials
• Technical Documentation - Detailed technical documentation

🏛️ Architecture Overview

GrowERP uses a modular architecture that promotes reusability and extensibility:

┌─────────────────────────────────────────────────────────────┐
│                    Applications Layer                        │
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────┐ │
│  │ Admin App   │ │ Hotel App   │ │Freelance App│ │Custom...│ │
│  └─────────────┘ └─────────────┘ └─────────────┘ └─────────┘ │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│                  Building Blocks Layer                      │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────┐ │
│ │growerp_core  │ │growerp_catalog│ │growerp_order │ │ ...  │ │
│ │growerp_models│ │growerp_inventory│ │_accounting  │ │      │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ └──────┘ │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│                    Backend Layer                            │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────┐ │
│ │GrowERP Comp. │ │Custom Comp.  │ │Mantle UDM    │ │Moqui │ │
│ │              │ │              │ │Mantle USL    │ │Frame │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ └──────┘ │
└─────────────────────────────────────────────────────────────┘

🧩 Building Blocks (Frontend)

• growerp_core - Foundation templates and UI components
• growerp_models - Data models and API clients
• growerp_catalog - Product and category management
• growerp_inventory - Warehouse and stock management
• growerp_order_accounting - Orders, invoices, and accounting
• growerp_user_company - User and company management
• growerp_marketing - Marketing campaigns and analytics
• growerp_website - Website content management
• growerp_activity - Task and activity tracking
• growerp_chat - Real-time communication

⚙️ Backend Components

• Moqui Framework - Enterprise-grade backend framework
• REST APIs - Automatic JSON serialization and authentication
• Entity Engine - ORM with automatic CRUD operations
• Service Engine - Business logic with transactions
• Security - Role-based access control

🌟 Key Features

✨ For Businesses

• Multi-platform - Web, Android, iOS from single codebase
• Modular Design - Use only what you need
• Industry-Specific - Pre-built applications for different sectors
• Scalable - From small business to enterprise
• Open Source - No licensing fees, full control

🛠️ For Developers

• Extensible Architecture - Create custom building blocks and components
• Modern Tech Stack - Flutter frontend, Moqui backend
• Comprehensive Documentation - Detailed guides for all aspects
• Active Community - Collaborative development environment
• Best Practices - Established patterns and conventions

🏢 For Organizations

• Cost Effective - 60% reduction in Total Cost of Ownership
• Rapid Development - 50% faster application development
• Customizable - Adapt to specific business requirements
• Future-Proof - Modular architecture supports evolution
• Community-Driven - Benefit from collective innovation

🚀 Getting Started

Prerequisites

• Java JDK 11 - Download
• Java JDK 17 - Download (for Gradle 8+)
• Flutter stable - Install
• Chrome Browser - Download
• Git - Download
• Android Studio - Download (optional)
• VS Code - Download (optional)

Manual Installation

1. Clone the repository:

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

2. Start the backend (in separate terminal):

   cd moqui
   # First time only
   ./gradlew build
   java -jar moqui.war load types=seed,seed-initial,install no-run-es
   
   # Regular startup
   java -jar moqui.war no-run-es

3. Run the Flutter application:

   cd flutter/packages/admin
   # First time only
   dart pub global activate melos 3.4.0
   export PATH="$PATH":"$HOME/.pub-cache/bin"
   melos clean
   melos bootstrap
   melos l10n --no-select
   melos build --no-select
   
   # Regular startup
   flutter run

4. Access the backend admin:

   • URL: http://localhost:8080/vapps
   • User: SystemSupport
   • Password: moqui

Docker Installation

For Docker-based installation, see the Docker README.

🎯 Use Cases & Applications

🏢 Admin Application

Complete ERP solution with:

• Product catalog management
• Inventory tracking
• Order processing
• Accounting and invoicing
• User and company management
• Website content management
• Marketing campaigns

🏨 Hotel Application

Specialized for hospitality:

• Room management
• Reservation system
• Guest services
• Housekeeping
• Billing and accounting

💼 Freelance Application

Project management focused:

• Client management
• Time tracking
• Project organization
• Invoicing
• Activity monitoring

🔧 Custom Applications

Build your own using:

• Existing building blocks
• Custom components
• Industry-specific workflows
• Tailored user interfaces

🤝 Contributing

We welcome contributions from developers of all skill levels! Here's how you can help:

🎯 Contribution Areas

• 🐛 Bug Fixes - Report and fix issues
• ✨ New Features - Building blocks, backend components, integrations
• 📚 Documentation - Improve guides, add examples, translations
• 🧪 Testing - Unit tests, integration tests, quality assurance
• 🎨 UI/UX - Design improvements, accessibility, themes

🚀 Getting Started

1. Read our Contributing Guide
2. Check the Extensibility Documentation
3. Follow our Code of Conduct
4. Join the community discussions

📈 High-Priority Areas

• Industry-specific building blocks (healthcare, education, manufacturing)
• Integration modules (payment, shipping, analytics)
• Localization and internationalization
• Performance and scalability improvements

📱 Screenshots

Admin Application

Mobile Screenshots

Main Menu	Products	Website

Accounting	Ledger	Company

Web/Tablet Screenshots

Main Menu

Company Management

Website Management

Order Management

Accounting

Ledger

Product Catalog

Hotel Application

Mobile Screenshots

Daily View	Weekly Menu	Rooms

Reservations	Accounting	Ledger

Web/Tablet Screenshots

Daily View

Weekly View

Room Management

Reservation System

Accounting

Financial Ledger

Generated Business Website

E-commerce Website

🌐 Community & Support

📞 Contact & Support

• Email: support@growerp.com
• Website: www.growerp.com
• GitHub Issues: Report bugs and request features
• GitHub Discussions: Community discussions

🤝 Community

• Contributors: Join our growing community of developers
• Documentation: Help improve and translate documentation
• Testing: Test new features and report issues
• Mentorship: Learn from experienced contributors

📈 Project Status

• License: CC0 1.0 Universal (Public Domain)
• Status: Active development
• Stability: Production ready
• Community: Growing open source ecosystem

🎯 Roadmap

🔮 Upcoming Features

• Enhanced mobile responsiveness
• Advanced reporting and analytics
• Additional industry-specific modules
• Improved internationalization
• Performance optimizations

🚀 Long-term Vision

• Comprehensive ecosystem of building blocks
• Industry-leading extensibility platform
• Global community of contributors
• Enterprise-grade scalability and performance

---

🌟 Star this repository if you find GrowERP useful!

🤝 Join our community and help shape the future of open-source ERP!

⭐ Star • 🍴 Fork • 📝 Contribute • 💬 Discuss