# Separator

> Divide content into groups with a thin line.

- Category: Data display
- Import: `import { Separator } from "@sagui/ui";`
- Page: /components/separator

```tsx
import { Separator } from "@sagui/ui";

export function Hero() {
  return (
    <div className="flex w-80 flex-col gap-4">
      <p className="type-body">Account</p>
      <Separator />
      <p className="type-body">Billing</p>
      <Separator label="or" />
      <div className="flex h-6 items-center gap-3 type-body">Edit <Separator orientation="vertical" /> Share</div>
    </div>
  );
}
```

## When to use

- Between groups in a menu, card or toolbar.
- A labeled divider such as “or” between sign-in options.

## When not to use

- Use spacing alone when the groups are already clear.
- Use Card or FormSection to group whole sections.

## Installation

Install the package and import the styles once. The [installation guide](/docs/installation) covers the Tailwind setup.

```bash
npm install @sagui/ui
```

## Usage

```tsx
import { Separator } from "@sagui/ui";

<Separator />
<Separator label="or" />
```

## Accessibility

- Decorative by default (hidden from screen readers). Set `decorative={false}` when the split carries meaning, and it renders `role="separator"` with its orientation.
