Skip to content

growerp/growerp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1,497 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

GrowERP - Open Source Modular ERP Platform

License: CC0-1.0 Flutter Moqui

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: Free trial 2 weeks period without credit card

Applications limited availability under test: dummy credit card always approved

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

Install Locally: see the manual installation below

๐Ÿ“š Documentation

๐Ÿš€ Quick Start: New to GrowERP? Start with the Extensibility Overview for a complete roadmap, then check the Building Blocks Guide for frontend development or the Backend Components Guide for backend development.

๐Ÿ“– Full Documentation Index: See docs/README.md for the complete documentation index โ€” 41+ guides organised by role, with reading paths for Project Managers, Architects, Frontend/Backend Developers, DevOps, QA, and more.

โญ Phase 12 - Assessment Landing Page Implementation (LATEST)

๐Ÿ—๏ธ Core Development & Architecture

๐Ÿ”ง Integration & APIs

๐Ÿš€ Deployment & Operations

๐Ÿ“‹ Business & Management

๐Ÿค Contributing & Community

๐Ÿ“– Additional Resources

๐Ÿ“ Documentation Status & Maintenance

The GrowERP documentation is actively maintained and regularly updated. Key features:

  • ๐Ÿ“Š Comprehensive Coverage: 25+ detailed guides covering all aspects of development and deployment
  • ๐Ÿ”— Cross-Referenced: All documents include links to related topics and examples
  • ๐ŸŽฏ Use Case Focused: Documentation organized by developer needs and experience levels
  • ๐Ÿ“ฑ Multi-Platform: Covers Web, Android, iOS, Linux, Windows, and macOS development
  • ๐Ÿค– AI-Ready: Includes AI integration guides and MCP server documentation

๐Ÿ’ก Documentation Navigation Tip: Start with the Extensibility Overview for a complete roadmap of all available documentation. Each guide includes cross-references and practical examples to help you find exactly what you need for your specific use case.

๐Ÿ”„ Contributing to Documentation: Found something missing or outdated? We welcome documentation contributions! See our Contributing Guide for how to improve the docs.

๐Ÿ›๏ธ 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_manufacturing - Bill of Materials, Work Orders, and Routings
  • growerp_manuf_liner - Custom liner manufacturing and production PDF generation
  • 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
  • growerp_courses - eLearning course and content management
  • growerp_sales - Sales pipeline and opportunity management
  • growerp_outreach - Outreach and lead engagement

โš™๏ธ 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

Manual Installation

  1. Clone the repository with all submodules:

    git clone https://github.com/growerp/growerp
    cd growerp
    git submodule update --init --recursive
    bash setup-backend.sh
  2. Start the backend (in separate terminal):

    cd moqui
    # First time only โ€” build and load initial data
    ./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
    # First time only
    dart pub global activate melos
    export PATH="$PATH":"$HOME/.pub-cache/bin"
    melos clean && melos bootstrap
    melos l10n --no-select
    melos build --no-select
    
    # Run the admin app
    cd packages/admin
    flutter run
  4. Access the backend admin:

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

๐ŸŽ“ eLearner Application

Student-facing learning platform:

  • Course enrollment and management
  • Learning progress tracking
  • Content delivery
  • Instructor and student management

๐Ÿฅ Health Application

Healthcare management:

  • Patient management
  • Appointment scheduling
  • Health records
  • Billing and accounting

๐ŸŽง Support Application

Customer support and ticketing:

  • Ticket management
  • Customer communication
  • Issue tracking and resolution
  • Reporting

๐Ÿ“Š Assessment Application

Lead capture and AI-scored assessment platform:

  • AI-powered assessment scoring
  • Landing page generation
  • Lead capture and management
  • Integration with Admin ERP

๐Ÿ”ง 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
Dynamic Menu System Ledger Company

Web/Tablet Screenshots

Main Menu
Company Management
Website Management
Order Management
Dynamic Menu System
Ledger
Product Catalog

Hotel Application

Mobile Screenshots

Daily View Weekly Menu Rooms
Reservations Orders Ledger

Web/Tablet Screenshots

Daily View
Weekly View
Room Management
Reservation System
Hotel Information
Financial Ledger

Generated Business Website

E-commerce Website

๐ŸŒ Community & Support

๐Ÿ“ž Contact & Support

๐Ÿค 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

  • Latest Release: 1.15.0
  • 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

About

GrowERP Flutter ERP for Android, IOS,Web,Linux and Windows using Moqui.org, Apache OFBiz , in English,French,German,Spanish, Thai and Dutch

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors