Components
Form Components
Reference index for all IremboHub Formly field components.
Each component page documents when to use the component, its full prop table, validation message keys, and copy-paste JSON examples.
Text and choice
| Component | Description |
|---|---|
| checkbox | Single opt-in / opt-out boolean |
| input | Single-line text field |
| multicheckbox | Multiple selections from a list |
| radio | Mutually exclusive radio buttons |
| textarea | Multi-line text field |
Dropdowns
| Component | Description |
|---|---|
| customcascadingdropdowns | Province → village hierarchical location picker |
| customdropdown | Single/multi-select dropdown, static or API-driven |
| customdropdowndatafetchpaginated | Paginated dropdown sourced through the integration engine |
| customdropdownpaginated | Paginated dropdown for large direct-API lists |
Dates and times
| Component | Description |
|---|---|
| customdatepicker | Date-only picker with range and weekday constraints |
| customdatetimepicker | Combined date-and-time picker |
| customtimepicker | Standalone time-of-day picker |
Identity and lookup inputs
| Component | Description |
|---|---|
| customapplicationnumberinput | Reference an existing IremboHub application by its number |
| customcrvsidinput | CRVS document lookup (birth/death/marriage certificates) |
| customcurrencyformatinput | Comma-formatted monetary amount input (e.g. 1,000,000 RWF) |
| customdoubleidinput | Paired dual-identity verification (e.g. marriage record) |
| customidinput | NID / Child ID / passport with live identity verification |
| customphonenumber | International phone input with country flag dropdown |
| customtininput | Company TIN with RDB/RRA registry verification |
File upload
| Component | Description |
|---|---|
| customfileupload | Base64 inline file upload |
| custominternalfileupload | CDN pre-upload file attachment |
Repeaters
| Component | Description |
|---|---|
| customdynamicrepeater | API-driven repeater that creates one row per fetched item |
| customexpansionrepeater | Repeater whose rows collapse into expandable panels |
| customlabelvaluerepeater | Simple user-driven repeater for short row templates |
| customrepeater | User-driven repeater with uniqueness, minItems, maxItems |
Tables
| Component | Description |
|---|---|
| customdatasettable | Read-only dataset table for tabular reference data |
| customdatatable | Read-only data table for reviewing fetched records |
| customeditabletable | Inline-editable grid with typed cells (text, number, email, date, select) |
| customitemselectiontable | Per-row add/remove action table, typically used in pairs |
Data fetch and triggers
| Component | Description |
|---|---|
| customconditionaldatafetch | Data fetch guarded by a precondition expression |
| customgenericdatafetch | Input that triggers an API lookup and populates downstream fields; also covers customdirectdatafetch for direct URL calls |
| custommultiselectdatafetch | Multi-select dropdown sourced from an integration fetch |
| customotpdatafetch | OTP-gated data fetch (sends a one-time code before populating fields) |
| genericbuttonfetch | Standalone button that triggers an API lookup on click (no input field) |
Informational
| Component | Description |
|---|---|
| customsectionmessagewithlink | Styled banner with optional title, HTML content, and clickable links |
Validators
| Page | Description |
|---|---|
| Cross-field validators | Compare fields against each other, enforce repeater row uniqueness, and validate JSON-keyed response values |
Validators
The full validator catalog — standard, date, file, multi-select, cross-field, repeater, and identity validators with their option shapes and message keys.
checkbox
A single boolean toggle. Use for consent declarations, confirmations, and opt-ins where the user must actively check a box to proceed.