# Flex

Component for creating flex layouts.

```jsx
<Flex gap="3">
  <Box width="64px" height="64px">
    <DecorativeBox />
  </Box>

  <Box width="64px" height="64px">
    <DecorativeBox />
  </Box>

  <Box width="64px" height="64px">
    <DecorativeBox />
  </Box>

  <Box width="64px" height="64px">
    <DecorativeBox />
  </Box>

  <Box width="64px" height="64px">
    <DecorativeBox />
  </Box>
</Flex>
```

## [API Reference](#api-reference)

This component is based on the `div` element and supports [common margin props](/themes/docs/overview/layout#margin-props).

Use these props to create flex layouts.

| Prop        | Type                                                    | Default          |
| ----------- | ------------------------------------------------------- | ---------------- |
| `as`        | `"div" \| "span"`                                       | `"div"`          |
| `asChild`   | `boolean`                                               | No default value |
| `display`   | `Responsive<"none" \| "inline-flex" \| "flex">`         | No default value |
| `direction` | `Responsive<enum>`                                      | No default value |
| `align`     | `Responsive<enum>`                                      | No default value |
| `justify`   | `Responsive<"start" \| "center" \| "end" \| "between">` | No default value |
| `wrap`      | `Responsive<"nowrap" \| "wrap" \| "wrap-reverse">`      | No default value |
| `gap`       | `Responsive<enum \| string>`                            | No default value |
| `gapX`      | `Responsive<enum \| string>`                            | No default value |
| `gapY`      | `Responsive<enum \| string>`                            | No default value |

The following props are shared between [Box](./box), [Flex](./flex), [Grid](./grid), [Container](./container) and [Section](./section) components. Read more about layout components in [Layout](/themes/docs/overview/layout).

| Prop              | Type                         | Default          |
| ----------------- | ---------------------------- | ---------------- |
| `p`               | `Responsive<enum \| string>` | No default value |
| `px`              | `Responsive<enum \| string>` | No default value |
| `py`              | `Responsive<enum \| string>` | No default value |
| `pt`              | `Responsive<enum \| string>` | No default value |
| `pr`              | `Responsive<enum \| string>` | No default value |
| `pb`              | `Responsive<enum \| string>` | No default value |
| `pl`              | `Responsive<enum \| string>` | No default value |
| `width`           | `Responsive<string>`         | No default value |
| `minWidth`        | `Responsive<string>`         | No default value |
| `maxWidth`        | `Responsive<string>`         | No default value |
| `height`          | `Responsive<string>`         | No default value |
| `minHeight`       | `Responsive<string>`         | No default value |
| `maxHeight`       | `Responsive<string>`         | No default value |
| `position`        | `Responsive<enum>`           | No default value |
| `inset`           | `Responsive<enum \| string>` | No default value |
| `top`             | `Responsive<enum \| string>` | No default value |
| `right`           | `Responsive<enum \| string>` | No default value |
| `bottom`          | `Responsive<enum \| string>` | No default value |
| `left`            | `Responsive<enum \| string>` | No default value |
| `overflow`        | `Responsive<enum>`           | No default value |
| `overflowX`       | `Responsive<enum>`           | No default value |
| `overflowY`       | `Responsive<enum>`           | No default value |
| `flexBasis`       | `Responsive<string>`         | No default value |
| `flexShrink`      | `Responsive<enum \| string>` | No default value |
| `flexGrow`        | `Responsive<enum \| string>` | No default value |
| `gridArea`        | `Responsive<string>`         | No default value |
| `gridColumn`      | `Responsive<string>`         | No default value |
| `gridColumnStart` | `Responsive<string>`         | No default value |
| `gridColumnEnd`   | `Responsive<string>`         | No default value |
| `gridRow`         | `Responsive<string>`         | No default value |
| `gridRowStart`    | `Responsive<string>`         | No default value |
| `gridRowEnd`      | `Responsive<string>`         | No default value |
| `alignSelf`       | `Responsive<enum>`           | No default value |
| `justifySelf`     | `Responsive<enum>`           | No default value |

<!--$-->

<!--/$-->