# Atlas — Animated UI Component for React

> Infinite pannable canvas — grab and throw a modulo-tiled grid of cards across an unbounded plane with weighted momentum, a faint coordinate grid that rises only while in motion, velocity parallax, and a soft edge vignette. Arrow-key panning and focusable tiles.

- Page: https://crucibleui.com/components/utility/atlas
- Category: [utility](https://crucibleui.com/components/utility)
- Tier: pro (one-time purchase, see https://crucibleui.com/pricing)
- Engine: css

## Install

```bash
npx shadcn@latest add @crucible/atlas
```

Pro install requires adding the token-bearing `@crucible` registry to components.json (issued at https://crucibleui.com/account after purchase).

Import from `@/components/crucible/atlas`.

## Props (`AtlasProps`)

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `items?` | `React.ReactNode[]` | `a built-in set of chart plates` | Tile contents. Each node fills one cell; the set repeats forever across the plane. |
| `cellSize?` | `number` | `180` | Cell size in px (tiles are square). |
| `gap?` | `number` | `18` | Gap between cells in px. |
| `friction?` | `number` | `0.92` | Momentum decay per frame at 60fps — lower stops sooner, higher glides longer. Tuned heavy by default: a table, not ice. |
| `paused?` | `boolean` | `false` | Freezes the physics loop (drag still pans 1:1). |
| `label?` | `string` | `"Pannable canvas"` | Accessible name for the region. |

Also accepts: `React.ComponentPropsWithoutRef<"div">`.

## Usage example

```tsx
"use client";

import { Atlas } from "@/components/crucible/atlas";

export default function AtlasDemo() {
  return (
    <div className="relative isolate flex h-full min-h-[360px] w-full items-center justify-center overflow-hidden rounded-xl bg-neutral-950">
      <Atlas className="h-full w-full" cellSize={168} gap={16} />
      <p className="pointer-events-none absolute bottom-4 left-0 right-0 z-10 text-center text-sm text-neutral-500">
        Drag to explore — throw the canvas and let it glide.
      </p>
    </div>
  );
}
```

## Accessibility & performance

Honors `prefers-reduced-motion` with a designed static frame or fade (never a blank box) and passes `className` through.
