make-app-group

Implements Make App record-list grouping with Entity Preset persistence and CanvasTable grouped rendering.

5|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/qfeius/make-platform-skills --skill make-app-group-qfeius
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: make-app-group
Source: https://github.com/qfeius/make-platform-skills/tree/main/skills/make-app-group
Command: npx skills add https://github.com/qfeius/make-platform-skills --skill make-app-group-qfeius

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @qfei-design/make-app-group, @qfei-design/canvas-table, and includes references (resource) components.

What problem does it solve? Building multi-level record grouping for Make App lists requires coordinating a grouping panel UI, Entity Preset persistence, Service record-groups contracts, groupFilter expression composition, and CanvasTable grouped rendering, which is error-prone when each layer is wired by hand. ## Core Features & Use Cases - Integrated grouping workflow: Connects @qfei-design/make-app-group panel, draft lifecycle, save-before-apply Preset writes, and grouped data loading into one controlled flow. - Service and expression contracts: Defines strict record-groups transport parsing, DNF-preserving groupFilter composition, and Make Data grouping-mode payload rules. - CanvasTable grouped rendering: Covers GroupTableComponent setup, root/child group loading, leaf-record pagination, and failure recovery via markGroupPageLoadFailed. - Use Case: A user asks to add three-level drag-and-drop grouping to a Make record list page; the Skill guides schema capability checks, Preset persistence, Service routes, and grouped table rendering end to end. ## Quick Start Use the make-app-group skill to add multi-level record grouping with Preset persistence and CanvasTable grouped rendering to my Make App list page.

Frequently Asked Questions about make-app-group

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add multi-level grouping to a Make App record list?

Install @qfei-design/make-app-group, build candidates from runtime schema fields with capabilities.groupable === true, and use RecordGroupPanel with useRecordGroupController. Persist the ordered {fieldKey, order} array to Entity Preset before applying, then render grouped data with CanvasTable GroupTableComponent.

How does groupFilter work with record grouping requests?

groupFilter is a separate Expression from filter, composed by appending one <fieldKey> == <literal> condition per selected group path value. When the existing expression has top-level OR branches, the new condition must be appended to every branch to preserve DNF.

Can Lookup fields be used for record grouping?

Lookup grouping is allowed when the runtime schema marks the field capabilities.groupable === true, which reflects backend validation of the relation shape. Platform code must not blanket-disable Lookup fields, though a project may hide them as a scoped V1 policy.

Why is group: [] rejected in Make Data API requests?

Data API group omitted or null means ordinary records mode, while group: [] enters grouping mode with no group item, which is invalid. Clearing a saved grouping uses Preset { group: [] }, and grouped leaf-record requests must omit group entirely.

How many grouping levels does make-app-group support?

The package contract fixes MAX_RECORD_GROUP_COUNT at three levels, where array index defines hierarchy: index 0 is root, index 1 is second level, index 2 is third. Duplicate field keys and a fourth entry are rejected during validation.

Why does my grouped CanvasTable page stop loading after a failed request?

A failed or cancelled leaf-page request must call markGroupPageLoadFailed(groupValue, page) so CanvasTable can retry that virtual page. Without this call, the page remains in a pending state and will not reload.