# Label (label)

> Uppercase, tracked, muted kicker that names a scene or page section.

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

## Install

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

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/label.json, files[].content).

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

## API

### `Label` (component)

Block-level Geist sans kicker at 26px, weight 600, 4px letter spacing, uppercase, in the dim token color. Sits top-left of a scene or above a section.

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `children` | `React.ReactNode` | required | Kicker text; rendered uppercase regardless of the source casing. |
| `style` | `React.CSSProperties` | none | Inline styles merged last; override color (for example color.soft on dark cards) or fontSize here. |

## Stage

fluid: A block div that fills its container's width. One line is 26px type at the font's normal line height (not set explicitly, so the exact height depends on Geist's metrics); long text wraps and adds lines.

## Examples

### Section kicker

```tsx
import { Label } from "@/jbm/ui/label"

<Label>Una idea a la vez</Label>
```

### On a dark card

```tsx
import { Label } from "@/jbm/ui/label"
import { color } from "@/jbm/lib/tokens"

<Label style={{ color: color.soft }}>Dark</Label>
```

## QA

- Confirm the text renders uppercase with visible tracking in the dim color on cream.
- Check a long kicker wraps cleanly inside the safe area, and that style overrides (color on dark surfaces) keep readable contrast.

## Related

Installs:

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

Installed by:

- [SceneFromSpec (scene-spec)](https://jbm-ui.bns.studio/catalog/scene-spec.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
