# Big (big)

> Display heading in Geist at weight 800 with tight tracking.

- Entry: component
- Category: UI
- Preview capabilities: none (still preview)
- Runtime: React
- Needs Remotion: no
- QA page: https://jbm-ui.bns.studio/c/big
- JSON: https://jbm-ui.bns.studio/catalog/big.json
- Registry item: https://jbm-ui.bns.studio/r/big.json (source code in files[].content)

## Install

```sh
npx shadcn@latest add @jbm/big
```

Also installs @jbm/tokens (registry dependencies install automatically).

## Required setup

1. Add the `@jbm` registry to components.json (keep any entries already there):

   ```json
   {
     "registries": {
       "@jbm": "https://jbm-ui.bns.studio/r/{name}.json"
     }
   }
   ```

2. Map `@/*` to `./src/*` in tsconfig.json `compilerOptions.paths`, so `@/jbm/…` imports resolve to src/jbm/.

## Files

Each file's source code is in the registry item JSON (https://jbm-ui.bns.studio/r/big.json, files[].content).

| Source path | Installs to | Import |
| --- | --- | --- |
| `registry/jbm/ui/big.tsx` | `src/jbm/ui/big.tsx` | `@/jbm/ui/big` |

## API

### `Big` (component)

Block-level display heading: Geist sans, weight 800, line-height 1.05, -2px letter spacing, ink by default. Children may include line breaks and accent spans.

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `children` | `React.ReactNode` | required | Heading content; use <br /> for deliberate line breaks and a span with color.accent for the one accent word. |
| `size` | `number` | `96` | Font size in stage pixels; 56 to 170 in practice. |
| `color` | `string` | `color.ink` | Text color; defaults to ink. Use color.bg on dark surfaces. |
| `style` | `React.CSSProperties` | none | Inline styles merged last, for example textAlign or maxWidth. |

## Stage

Declared in stage pixels at the documented defaults.

| Orientation | Width | Height |
| --- | --- | --- |
| Landscape (1920×1080) | fill | 101 |
| Vertical (1080×1920) | fill | 101 |

One line at the default size 96 with line-height 1.05: 96 × 1.05 ≈ 101 stage px. Height is lines × size × 1.05; the block div fills its container's width and wraps long text.

## Examples

### Headline with an accent phrase

```tsx
import { Big } from "@/jbm/ui/big"
import { color } from "@/jbm/lib/tokens"

<Big size={76}>
  Ideas que<br />
  <span style={{ color: color.accent }}>se entienden.</span>
</Big>
```

### Cream heading on a dark card

```tsx
import { Big } from "@/jbm/ui/big"
import { color } from "@/jbm/lib/tokens"
import { Card } from "@/jbm/ui/card" // install @jbm/card separately

<Card dark><Big size={48} color={color.bg}>Surface</Big></Card>
```

## QA

- Check the largest size used still fits the safe area in both orientations; portrait usually needs a smaller size or manual line breaks.
- Confirm tight tracking does not collide glyphs at small sizes (below about 56px) and only one span uses the accent.

## Related

Installs:

- [Tokens (tokens)](https://jbm-ui.bns.studio/catalog/tokens.md)

Installed by:

- [Counter (counter)](https://jbm-ui.bns.studio/catalog/counter.md)
- [SceneFromSpec (scene-spec)](https://jbm-ui.bns.studio/catalog/scene-spec.md)

Imported in examples:

- [Card (card)](https://jbm-ui.bns.studio/catalog/card.md)

## More

- [llms.txt](https://jbm-ui.bns.studio/llms.txt): index of every item
- [catalog.json](https://jbm-ui.bns.studio/catalog.json): every item as JSON
- [Agent contract](https://jbm-ui.bns.studio/docs/agent-contract.md): what each field means
