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
Applications limited availability under test: dummy credit card always approved
- Admin next version: admin.growerp.org
- Hotel: hotel.growerp.org
- Freelance: freelance.growerp.org
- Marketing: marketing.growerp.org
- Rental: rental.growerp.org
- Agents: agents.growerp.org
- Support: support.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
- 🔐 Registration, Login & Trial Specification - Startup company resolution, registration, tenant setup, login state machine and evaluation period
- 🤖 Invoice Scan & AI Extraction - Invoice scanning and AI-powered data extraction with Google Gemini
- 🤖 LLM & API Key Architecture - How GrowERP uses LLMs, resolves API keys, and enforces token limits, plus a catalog of Gemini/Vertex AI (Veo 2) and GenUI features
- 🧠 Agent Control Center (ADK) - Guide to multi-agent orchestration, tool scoping, and RAG knowledge ingest
- 🎮 Agent Demo Walkthrough - Test the GrowERP Operations Team from the agent catalog
- ✨ 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
- 📣 Marketing & Sales Plan - Master go-to-market plan, dogfooded on GrowERP itself
- 📖 Marketing, Outreach & CRM User Manual - End-user guide for the marketing, outreach and CRM modules
- 📊 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 - Apache License 2.0
- 🎯 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, Hotel, Freelance, Marketing, Rental, Agents, │
│ Support, Assessment, Website, 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
- growerp_hr - Employee and human resources management
- growerp_rental - Rental scheduling, availability and Gantt-style booking
- growerp_wiki - Wiki pages and documentation management
- growerp_adk - AI agent chat and control center UI
⚙️ Backend Components
- moqui-adk - Agent Development Kit for multi-agent orchestration and governance
- moqui-mcp - Model Context Protocol for external AI tool integration
- 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-jdkor 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 ./setup-backend.sh # (or windows: ./setup-backend.ps1) -
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 #(windows: ignore error with flutter-startup.sh) melos l10n --no-select melos build --no-select # Run the admin app cd packages/admin flutter run -
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
- AI Agent orchestration and control center
- LLM system usage tracking and token limits
🏨 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
📣 Marketing Application
Campaigns, content and lead engagement:
- Marketing campaigns and content management
- Website content management
- Outreach and lead engagement
- Sales pipeline and opportunities
🏗️ Rental Application
Equipment and asset rental:
- Rental scheduling and availability (Gantt view)
- Rate management
- Billing and accounting
- Utilization statistics
🤖 Agents Application
AI agent governance and organization setup:
- AI agent chat, jobs and approvals
- Action audit trail
- Company, employees and website setup
- System configuration
🎧 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
- Read our Contributing Guide
- Check the Extensibility Documentation
- Follow our Code of Conduct
- 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
| Dashboard | Company | Ledger |
|---|---|---|
 |
 |
 |
| Orders | Employees |
|---|---|
 |
 |
Web/Tablet Screenshots
| Dashboard |
|---|
 |
| Company |
|---|
 |
| Orders |
|---|
 |
| Ledger |
|---|
| <img |
