uc-apx create region flexbox-container

Insert a themeTemplateComponent/flexboxContainer region — a layout-only container (no SQL, no columns) that arranges its CHILD regions in a flex row or column with declarative gap / alignment / wrapping.

This is a design helper, not a content component: use it to group regions into equal-height rows, side-by-side columns, or responsive wrapping layouts instead of fighting the 12-column grid. After creating it, point child regions at it with layout.parentRegion: @<this-id> and slot: subRegions.

Usage

uc-apx create region flexbox-container [flags]

Flags

Flag	Type	Default	Description
--align-items	string		Cross-axis alignment: start, center, end, stretch (settings.alignItems)
--column-span	int		12-col grid span for the container’s own layout (0 = omit)
--direction	string		Flex direction: row or column (settings.direction)
--dry-run			Print rendered region to stdout without writing
--flex-behavior	string		Flex behavior: growIfNeeded, … (settings.flexBehavior)
--force			Replace an existing same-id region on the page
--gap	string		Gap between items: sm, md, lg, … (settings.gap)
--id	string		Region id (default: kebab-case of —name). Child regions reference this as @<id>.
--justify-content	string		Main-axis distribution: start, center, end, spaceBetween, … (settings.justifyContent)
--name	string		Display name of the region [required]
--no-new-row			Emit startNewRow: false so this container sits next to the previous region
--page	string		Target page (numeric ID, alias, or name) [required]
--sequence	int		Layout sequence (default: max existing + 10)
--slot	string	body	Page slot to place the container in
--wrap	string		Wrapping: wrap or noWrap (settings.wrap)

Global Flags

Flag	Type	Default	Description
--app-dir	string	.	Path to the APEX application directory
--json-pretty			Output in pretty-printed JSON (human-readable) instead of minified JSON
--toon			Output in TOON format (human-readable, token-efficient) instead of JSON

Example Generated APEXlang

Using --dry-run to preview the generated construct (no files are written):

uc-apx --app-dir examples/brookstrut create region flexbox-container --page 46 --name Cards Row --direction row --gap lg --align-items stretch --dry-run

Generated APEXlang

region cards-row (
        name: Cards Row
        type: themeTemplateComponent/flexboxContainer
        layout {
            sequence: 50
            slot: body
        }
        componentAppearance {
            display: regionOnly
        }
        settings {
            direction: row
            gap: lg
            alignItems: stretch
        }
    )