Skip to content
npm

Feedback & status

Badge (badge)

A small colored label: Active, Draft, Overdue.

PropertyWhat it does
TextThe label.
ToneSemantic shade: info, success, warning, risk, neutral.
PillFully rounded corners.
Variant expression / Icon expressionDrive the look from data, e.g. value overdue → risk tone.
Link URLMake the badge clickable.

Message card (messageCard)

A highlighted box with icon, title, and text, for inline notices ("Your application is being reviewed").

PropertyWhat it does
Title / Description textThe heading and extended content.
Variantinfo, success, warning, error.
Show icon / IconThe leading icon.
DismissibleThe user can close the card manually.
Primary / Secondary button textOptional CTA buttons (wire them with actions).

Combine with visibleIf to show it only in the relevant state:

text
visibleIf: {status} == "rejected"

Toast (toast)

A temporary notification. Usually you don't place this element, because toasts are shown by actions (showToastAfter or a toast action). Place a Toast element only when you need a persistent, configured message area.

PropertyWhat it does
Title / Description textThe message.
Variant / PositionType and screen corner.
Auto hide + Auto hide timeout (ms)Self-dismissal, e.g. 4000.

Stats card (statsCard)

A KPI tile: big number, label, and optional trend. Feed the value with an expression or a data source. Great in dashboard rows.

PropertyWhat it does
Value textThe primary displayed value. Expression example: countInArray({orders}, "id").
Trend directionup, down, or neutral.
Trend textShort change explanation next to the indicator.
Trend direction expression / Variant expression / Icon expressionDrive trend, tone, and icon from data.

Progress bar (progressBar)

A completion indicator. Value 0-100 from a fixed number or expression:

text
Expression: len({completedSteps}) / 5 * 100
PropertyWhat it does
Display typeHorizontal bar or circular indicator.
Value label modeShow a percentage, the raw value, or current/max.

Stepper / Timeline (progressFlow)

Step indicator with named stages (Submitted → Reviewed → Approved).

Each item in the Items list has:

Item fieldWhat it does
Step / Label / DescriptionThe stage identity and texts.
Visible ifHide a stage conditionally.
Active if / Completed if / Disabled ifConditions driving each state, e.g. {el1} == 1 or {score} > 80.

Element-level properties:

PropertyWhat it does
Active indexDefault active step.
Active step expressionCalculate the active step from data, for business conditions across several fields.
Active step data pathRead the active index from external state.
Steps data pathLoad the step list from data or a source response (data.steps).
Show numbers / Show connectorNumbering and the connecting line.
Allow manual navigationUsers can click between steps themselves.
Step template / Step template refFully custom step markup, inline or from the template library.

The current step is readable in expressions:

text
{approvalFlow.selectedStep}        → active step name
{approvalFlow.selectedStepIndex}   → active step index

Example: visibleIf: {approvalFlow.selectedStep} == "Approved" on a download button.