# React Native Stack (HStack, VStack)

> React Native Stack, HStack and VStack layout components for iOS, Android and the web: rows and columns with gap and padding from the theme's spacing scale, alignment and wrapping.

# Stack

Lays its children out in a column or a row, with the space between them taken from the theme's spacing scale. `VStack` and `HStack` are a column and a row.

```tsx
import { HStack, Stack, VStack } from 'patine-ui';
```

```tsx live
import { Button, HStack, Text, VStack } from 'patine-ui';

export default function Example() {
  return (
    <VStack gap="md">
      <Text>Delete this project? This can't be undone.</Text>
      <HStack gap="sm" justify="flex-end">
        <Button variant="outline">Cancel</Button>
        <Button variant="destructive">Delete</Button>
      </HStack>
    </VStack>
  );
}
```

## Example: a notification row

A notification in an activity feed, built from stacks alone: an `HStack` puts the avatar beside the text, a `VStack` stacks the message over its time, and a wrapping `HStack` keeps the buttons tidy on a narrow screen.

```tsx live
import { Avatar, Box, Button, HStack, Text, VStack } from 'patine-ui';

export default function Example() {
  return (
    <Box border radius="lg" padding="md" style={{ width: '100%', maxWidth: 440 }}>
      <HStack gap="md" align="flex-start">
        <Avatar name="Priya Shah" src="https://picsum.photos/id/338/120/120" />
        <VStack gap="sm" style={{ flex: 1 }}>
          <VStack gap="xs">
            <Text>
              <Text weight="semibold">Priya Shah</Text> asked you to review <Text weight="semibold">Checkout v2</Text>
            </Text>
            <Text size="sm" color="textSecondary">12 minutes ago · Mobile team</Text>
          </VStack>
          <HStack gap="sm" wrap>
            <Button size="sm">Review</Button>
            <Button size="sm" variant="outline">Later</Button>
          </HStack>
        </VStack>
      </HStack>
    </Box>
  );
}
```

## Spacing

`gap` and `padding` take a step of the spacing scale, `xs` (4) to `xl` (24), or a number of points. Change the scale in the [theme](../guides/theming) and every stack follows.

## Props

Stack also takes `View` props. `HStack` and `VStack` take the same, without `direction`.

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `direction` | `'column' \| 'row'` | `'column'` | Stack only. |
| `gap` | `'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| number` | — | Space between children. |
| `padding` | `'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl' \| number` | — | Space inside the edges. |
| `align` | `ViewStyle['alignItems']` | — | Cross-axis alignment. |
| `justify` | `ViewStyle['justifyContent']` | — | Main-axis alignment. |
| `wrap` | `boolean` | `false` | Wrap onto new lines when the children don't fit. |
| `theme` | `DeepPartial<Theme>` | — | Theme override. |
