# Living Documents

> A single document page that builds, annotates and finalises itself on a loop.

- Collection: Illustrations
- Tier: pro
- Docs: https://geturui.com/docs/living-documents
- Install: `npx shadcn@latest add @geturui-pro/living-documents`
- Dependencies: motion

## Variants

### Contract

A clause is highlighted and annotated, the signature writes itself and a stamp lands.

Install: `npx shadcn@latest add @geturui-pro/living-documents-contract`

```tsx
import { LivingDocumentContract } from "@/components/illustrations/living-documents/contract";

export function ContractIllustration() {
  return (
    <div className="rounded-xl border border-border bg-surface p-4">
      <LivingDocumentContract className="w-full" />
    </div>
  );
}
```

| Prop | Type | Default | Description |
|---|---|---|---|
| speed | `number` | 1 | Speed multiplier for the loop (seven seconds at 1). |
| title | `string` | — | Accessible description of the scene, used as the aria-label. |
| className | `string` | — | Classes for the SVG; it fills its container width and keeps its ratio. |

### Report

KPI tiles, growing bars and a trend line build the page while the next page slides out.

Install: `npx shadcn@latest add @geturui-pro/living-documents-report`

```tsx
import { LivingDocumentReport } from "@/components/illustrations/living-documents/report";

export function ReportIllustration() {
  return (
    <div className="rounded-xl border border-border bg-surface p-4">
      <LivingDocumentReport className="w-full" />
    </div>
  );
}
```

| Prop | Type | Default | Description |
|---|---|---|---|
| speed | `number` | 1 | Speed multiplier for the loop (seven seconds at 1). |
| title | `string` | — | Accessible description of the scene, used as the aria-label. |
| className | `string` | — | Classes for the SVG; it fills its container width and keeps its ratio. |

## Accessibility

- Rendered as a single SVG with role="img" and an aria-label you can override with `title`; nothing inside is focusable.
- Under prefers-reduced-motion the scene renders one meaningful still frame: no loops, no timers.
- Colours come from the GetUrUI tokens only, so the scene follows light and dark themes automatically.

## Source

Pro item — send `Authorization: Bearer <registry token>` to include the source.
