QQQ is a powerful, open source, metadata-driven application framework designed specifically for engineers who want to build business applications quickly without starting from scratch.

🚀 What Makes QQQ Different?

QQQ gives you a complete foundation - you define your data models, business logic, and UI through configuration and metadata, then QQQ handles the heavy lifting. No more boilerplate code, no more framework decisions, just rapid application development.

🔓 Open Source & Full Control

QQQ is 100% open source - you have complete ownership and control:

💻 Your Code: Full access to QQQ's source code
🗄️ Your Data: All data stays in your systems, never leaves your control
🏗️ Your System: Deploy anywhere - on-premises, cloud, or hybrid
🔒 No Vendor Lock-in: No SaaS subscriptions, no proprietary dependencies
⚡ Full Customization: Modify, extend, and adapt QQQ to your exact needs
🌍 Community Driven: Built by engineers, for engineers

You own everything. You control everything. No surprises.

✨ Core Capabilities

🔧 Data Management: RDBMS, filesystem, MongoDB, SQLite support
⚡ Business Logic: Actions, processes, automation, scheduled jobs
🎨 User Interface: React dashboard with Material-UI components
🌐 API Layer: REST endpoints, CLI tools, Lambda functions
🔌 Extensibility: Custom modules, widgets, and integrations

🏗️ Architecture

QQQ uses a metadata-driven architecture where everything is defined through configuration rather than code:

graph LR
    subgraph "Frontend"
        A[React Dashboard<br/>Material-UI]
    end
    
    subgraph "Middleware"
        B[Javalin HTTP Server<br/>PicoCLI Commands<br/>Lambda Functions]
    end
    
    subgraph "Backend"
        C[Core Framework<br/>RDBMS Module<br/>Filesystem Module<br/>MongoDB Module]
    end
    
    A <--> B
    B <--> C

🚀 Quick Start

Prerequisites

Java 17+ (required for QQQ features)
Maven 3.8+ (for build system)

Build Locally

# Clone the repository
git clone git@github.com:Kingsrook/qqq.git
cd qqq

# Build everything
mvn clean install

# Run with sample project
mvn clean install -P withSample

Use in Your Project

<dependency>
    <groupId>com.kingsrook.qqq</groupId>
    <artifactId>qqq-backend-core</artifactId>
    <version>0.27.0</version>
</dependency>

<!-- Add backend modules as needed -->
<dependency>
    <groupId>com.kingsrook.qqq</groupId>
    <artifactId>qqq-backend-module-rdbms</artifactId>
    <version>0.27.0</version>
</dependency>

📚 Documentation

📖 Complete Documentation Wiki - Start here for comprehensive guides

🏠 Home - Project overview and quick start
🏗️ Architecture - System design and principles
🔧 Development - Setup and contribution guide
📦 Modules - Available components and usage
🚀 Building - Local development workflow

🤝 Contributing

QQQ is open source and welcomes contributions!

🐛 Report Issues - Bug reports and feature requests
📝 Contribution Guide - How to contribute code and documentation
🔍 Code Standards - QQQ's coding standards and review process

First time contributing? Start with our Developer Onboarding Guide to get your environment set up.

🏢 About Kingsrook

QQQ is built by Kingsrook - making engineers more productive through intelligent automation and developer tools.

Website: https://qrun.io
Contact: contact@kingsrook.com
GitHub: https://github.com/Kingsrook

📄 License

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE.txt file for details.

Ready to build faster with full control? Get started with QQQ today!