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

Admin App with complete functionality: Web | Linux | Windows | MacOs | Android | iOS

Applications limited availability under test: dummy credit card always approved

Admin next version: admin.growerp.org
Hotel: hotel.growerp.org
Freelance: freelance.growerp.org

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)

Assessment Landing Page Explanation ⭐ PHASE 12 - Complete technical guide for FTL landing page + Flutter app integration, MIME type configuration, and Phase 12 updates
GrowERP Assessment & Landing Page Architecture - Package design and dual-ID strategy

🏗️ Core Development & Architecture

📖 Extensibility Overview - Complete guide to GrowERP's modular architecture and development patterns (41+ documents, 9,500+ lines)
🧩 Building Blocks Guide - Create Flutter packages (growerp_* packages)
⚙️ Backend Components Guide - Develop Moqui components and services
🎨 Design Patterns - Established patterns and conventions for consistent development
📝 Code Templates - Ready-to-use templates for rapid development
🤖 AI Development Guide - AI-assisted development best practices

🔧 Integration & APIs

🔗 Data Models Guide - Frontend-backend data model integration
📡 Flutter-Moqui REST Backend Interface - Complete guide to REST API communication with practical code examples
🤖 Invoice Scan & AI Extraction - Invoice scanning and AI-powered data extraction with Google Gemini
🤖 Generative AI Integration Guide - Comprehensive architectural breakdown of all Gemini, Vertex AI (Veo 2), and GenUI features
✨ AI Landing Page Generation - Generate professional landing pages with AI and internet research
💳 Stripe Payment Processing - Complete payment integration guide
🌐 WebSocket Notifications - Real-time notification system
🕐 Timezone Management - Handle timezone differences between client and server

🚀 Deployment & Operations

🐳 Docker Installation - Containerized deployment and development
📦 Snap Distribution - Linux Snap package distribution
⚙️ Backend URL Selection - Backend configuration and routing

📋 Business & Management

📊 Management Summary - Strategic overview for decision makers
📈 Leads Management - Lead import and export processes
💰 Subscription Functions - Subscription and billing management

🤝 Contributing & Community

🔧 Contributing Guide - How to contribute to GrowERP
📜 Code of Conduct - Community guidelines and expectations
📄 License - CC0 1.0 Universal (Public Domain)
🎯 AI Development Guide - AI-assisted development best practices and prompts

📖 Additional Resources

🌐 User Documentation - End-user guides, tutorials, and support
📚 Technical Documentation - Comprehensive technical documentation and examples
📂 Documentation Examples - Code examples and implementation samples

📝 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

OpenJDK 21 - sudo apt install openjdk-21-jdk or Download
Flutter stable - Install
Chrome Browser - Download
Git - Download
Android Studio - Download (optional)
VS Code - Download (optional)

Manual Installation

Clone the repository with all submodules:

git clone https://github.com/growerp/growerp
cd growerp
git submodule update --init --recursive
bash setup-backend.sh

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

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