Building Apps

Create user interfaces and apps in qqq

Overview

qqq automatically generates admin interfaces for your tables and processes. You can also create custom apps with tailored experiences.

Auto-Generated UI

Every table gets:

List View - Searchable, sortable data grid

Detail View - Record viewer/editor

Create Form - New record entry

Bulk Actions - Multi-record operations

Custom Apps

Define custom apps for specific workflows:

Java

@QAppMetaData(name = "warehouse")
public class WarehouseApp implements AppMetaDataProducer {
    @Override
    public QAppMetaData produce(QInstance qInstance) {
        return new QAppMetaData()
            .withName("warehouse")
            .withLabel("Warehouse Management")
            .withIcon("warehouse")
            .withSections(List.of(
                new QAppSection()
                    .withName("inventory")
                    .withLabel("Inventory")
                    .withTables(List.of("item", "location")),
                new QAppSection()
                    .withName("operations")
                    .withLabel("Operations")
                    .withProcesses(List.of("receiveShipment", "pickOrder"))
            ));
    }
}

Widgets

Add dashboard widgets to apps:

Charts - Visualize data

KPIs - Key metrics

Tables - Data summaries

Custom - Build your own

Permissions

Control access at the app, table, and field level.

Next Steps

Building Reports - Add reporting

Extending qqq - Custom widgets