> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equa.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# EquaFormLayout

> Design system reference for EquaFormLayout, including Storybook, Figma, screenshots, and usage guidance

# EquaFormLayout

> **Last Verified:** 2026-05-20 | **Storybook source:** `equa-patternlib-nextjs/stories/EquaFormLayout.stories.tsx`, Line: 7

## Purpose

Form field rows, labels, helper text, and gateway-aligned input composition.

## Storybook

| Story           | Reference                                                                        |
| --------------- | -------------------------------------------------------------------------------- |
| Single Column   | [Storybook](http://localhost:6006/?path=/story/equa-formlayout--single-column)   |
| Two Columns     | [Storybook](http://localhost:6006/?path=/story/equa-formlayout--two-columns)     |
| With Errors     | [Storybook](http://localhost:6006/?path=/story/equa-formlayout--with-errors)     |
| Complex Form    | [Storybook](http://localhost:6006/?path=/story/equa-formlayout--complex-form)    |
| No Header       | [Storybook](http://localhost:6006/?path=/story/equa-formlayout--no-header)       |
| All Field Types | [Storybook](http://localhost:6006/?path=/story/equa-formlayout--all-field-types) |

## API And Props

| Prop or Control | Source            | Notes                                |
| --------------- | ----------------- | ------------------------------------ |
| `title`         | Storybook control | See source story for accepted values |
| `columns`       | Storybook control | See source story for accepted values |

Sources:

* `equa-patternlib-nextjs/src/components/formlayout/formlayout.tsx`, Line: 5
* `equa-patternlib-nextjs/stories/EquaFormLayout.stories.tsx`, Line: 7

## Figma

UNVERIFIED -- requires Figma node assignment

## Screenshots

| State           | Asset                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Equa dark theme | <img src="https://mintcdn.com/equainc/WF4vvyO1PBrsp7n_/images/design-system/components/equa-form-layout/equa-formlayout--single-column-equa.png?fit=max&auto=format&n=WF4vvyO1PBrsp7n_&q=85&s=5726e1628491576c469493618e6d88d5" alt="EquaFormLayout dark theme" width="1366" height="900" data-path="images/design-system/components/equa-form-layout/equa-formlayout--single-column-equa.png" />          |
| Light theme     | <img src="https://mintcdn.com/equainc/WF4vvyO1PBrsp7n_/images/design-system/components/equa-form-layout/equa-formlayout--single-column-light.png?fit=max&auto=format&n=WF4vvyO1PBrsp7n_&q=85&s=ec348c15a520b6d58da63bb2deab5cba" alt="EquaFormLayout light theme" width="1366" height="900" data-path="images/design-system/components/equa-form-layout/equa-formlayout--single-column-light.png" /> |

## Usage Notes

* Prefer this component over local one-off UI for matching product states.
* Keep new variants represented in Storybook before adding docs references here.
* Use token-backed colors, spacing, radius, and shadows from [Foundations](/architecture/design-system/foundations).

## Accessibility Notes

* Preserve keyboard and focus behavior from the source component.
* Any icon-only controls must provide an accessible label in consuming product code.
* Validate color contrast in both Equa dark and light theme screenshots before release.