design token

Spacing

Consistent scale for padding, margins, gaps, and layout across all components and frameworks.

A consistent scale for padding, margins, gaps, and other spatial relationships. All values use rem units for scalability and accessibility.

Scale

scale · spacing
4xs
0.2rem · 2px
3xs
0.4rem · 4px
2xs
0.6rem · 6px
xs
0.8rem · 8px
sm
1.2rem · 12px
md
1.6rem · 16px
lg
2.0rem · 20px
xl
2.4rem · 24px
2xl
2.8rem · 28px
3xl
3.2rem · 32px
4xl
3.6rem · 36px
5xl
4.0rem · 40px
6xl
4.4rem · 44px
7xl
4.8rem · 48px
8xl
5.2rem · 52px
9xl
5.6rem · 56px
10xl
6.0rem · 60px
11xl
6.4rem · 64px

Usage

Padding & Margin

import { css } from "@pindoba/styled-system/css";

<div className={css({ padding: "md" })}>Uniform padding</div>

<div className={css({ paddingX: "lg", paddingY: "sm" })}>
  Asymmetric padding
</div>

<div className={css({ marginX: "auto", marginY: "lg" })}>
  Centered with vertical margin
</div>

Gap

<div className={css({ display: "flex", gap: "md" })}>
  <div>Item 1</div>
  <div>Item 2</div>
</div>

<div className={css({
  display: "grid",
  gridTemplateColumns: "repeat(3, 1fr)",
  gap: "lg",
})}>
  <div>Grid item</div>
  <div>Grid item</div>
  <div>Grid item</div>
</div>

Responsive Spacing

<div
  className={css({
    padding: { base: "sm", md: "md", lg: "lg" },
  })}
>
  Responsive padding
</div>

Best Practices

  • 4xs2xs: Fine-tuning, icon gaps, compact elements
  • xs: Tight spacing between related elements
  • sm: Close relationships, form field gaps
  • md: Standard spacing, comfortable default
  • lgxl: Generous spacing, component separation
  • 2xl11xl: Major layout spacing, hero sections