VStack

VStack is a convenience wrapper around Stack with a fixed vertical (column) direction. Use it for vertical layouts.

Open in Storybook

Import

import { VStack } from "@tosui/react";

Basic usage

Preview

Code

<VStack gap={4}>
  <Box p={4} bg="primary-subtle">Item 1</Box>
  <Box p={4} bg="accent-subtle">Item 2</Box>
  <Box p={4} bg="success-subtle">Item 3</Box>
</VStack>

Alignment

Preview

Centered

Items

Here

Code

<VStack gap={4} align="center" p={4} bg="surface" border="thin" borderColor="border">
  <Box p={4} bg="primary-subtle" w="200px">Centered</Box>
  <Box p={4} bg="accent-subtle" w="150px">Items</Box>
  <Box p={4} bg="success-subtle" w="100px">Here</Box>
</VStack>

Common patterns

Form layout

<VStack gap={4} align="stretch">
  <Input placeholder="Name" />
  <Input placeholder="Email" />
  <Textarea placeholder="Message" />
  <Button>Submit</Button>
</VStack>

Card content

<Card>
  <CardBody>
    <VStack gap={3} align="start">
      <Heading size="xl">Card Title</Heading>
      <Text color="foreground-muted">Card description goes here.</Text>
      <Button size="sm">Learn More</Button>
    </VStack>
  </CardBody>
</Card>

Props reference

All convenience props (align, justify, wrap) accept responsive objects in addition to simple values.

Prop	Type	Default	Description
gap	ResponsiveValue<0-32>	-	Gap between children (spacing multiplier)
align	ResponsiveValue<"start" | "center" | "end" | "stretch" | "baseline">	-	Cross-axis alignment
justify	ResponsiveValue<"start" | "center" | "end" | "space-between" | "space-around" | "space-evenly">	-	Main-axis alignment
wrap	ResponsiveValue<boolean>	false	Enable flex wrapping
as	ElementType	"div"	HTML element to render

VStack accepts all Stack props except direction.

TypeScript

import { VStack, type VStackProps, type VStackOwnProps } from "@tosui/react";