Docyrus

Grid

Responsive grid layout with configurable columns, gap control, and spanning grid items.

iOSAndroid
Preview Grid on your device

Scan with Expo Go

Download Expo Go, then scan the QR code to preview native components.

Installation

pnpm dlx @docyrus/cli add @docyrus/rn-grid

Usage

import { Grid, GridItem } from '@/components/docyrus-native/grid';

<Grid columns={3} gap={4}>
  <GridItem><Text>1</Text></GridItem>
  <GridItem><Text>2</Text></GridItem>
  <GridItem span={2}><Text>Spans 2 columns</Text></GridItem>
  <GridItem><Text>4</Text></GridItem>
</Grid>

API Reference

Grid

PropTypeDefaultDescription
childrenReactNode—Grid items
columnsnumber2Number of grid columns
gapnumber0Gap size (theme spacing key or pixel value)
columnGapnumber—Column gap override
rowGapnumber—Row gap override
alignItemsViewStyle['alignItems']—Cross-axis alignment
justifyContentViewStyle['justifyContent']—Main-axis alignment
classNamestring—Additional CSS classes

GridItem

PropTypeDefaultDescription
childrenReactNode—Item content
spannumber1Number of columns to span
classNamestring—Item CSS classes

Type Exports

TypeDescription
GridPropsProps for Grid component
GridItemPropsProps for GridItem component

On this page