# GetStartedVisual

Illustrates one step of a get started flow at the top of its card.

[View source and API](https://github.com/tempoxyz/ds/blob/main/src/web/components/GetStartedVisual.tsx)

Figma: [Content/Get Started Visual](https://www.figma.com/design/yE96kcymnNR88PJp6G1sPs?node-id=5227-3110)

## Overview

A get started visual renders a 320 by 160px illustration on a dark ground. `step` selects the artwork of connecting, adding funds, or adding a passkey.

## Examples

### Basic

Set `step` to `connect` (default), `funds`, or `passkey`.

```tsx
/** Demonstrates GetStartedVisual in the documentation. @module */
import { GetStartedVisual, style } from '@tempoxyz/ds'

export function Demo() {
  return (
    <div {...styles.frame()}>
      <GetStartedVisual step="connect" />
    </div>
  )
}

namespace styles {
  export const frame = style({ maxWidth: '20rem !custom', width: '100% !custom' })
}
```

[View example source](https://github.com/tempoxyz/ds/blob/main/docs/src/examples/demos/GetStartedVisual/Basic.tsx)

### Steps

Each step of the flow has its own artwork.

```tsx
/** Demonstrates GetStartedVisual in the documentation. @module */
import { GetStartedVisual, style } from '@tempoxyz/ds'

export function Demo() {
  return (
    <div {...styles.row()}>
      <GetStartedVisual step="connect" />
      <GetStartedVisual step="funds" />
      <GetStartedVisual step="passkey" />
    </div>
  )
}

namespace styles {
  export const row = style({ display: 'flex', flexWrap: 'wrap', gap: '16' })
}
```

[View example source](https://github.com/tempoxyz/ds/blob/main/docs/src/examples/demos/GetStartedVisual/Steps.tsx)

## Anatomy

Import the component.

```tsx
import { GetStartedVisual } from '@tempoxyz/ds'

<GetStartedVisual />
```

## Guidelines

### When to Use

* Open each card of a get started list, above the title of its step.

### When Not to Use

* Use [Visual](/docs/components/visual) for the top of a modal.
* Use [IconTile](/docs/components/icon-tile) for a step that needs only an icon.

### Match the Artwork to the Step

**Do:** Show the funds artwork on the step that adds funds.

```tsx
<GetStartedVisual step="funds" />
```

**Don't:** Reuse one artwork for every step.

```tsx
<GetStartedVisual step="passkey" />
```

### Use One Visual per Card

Place one visual at the top of a card. Two visuals in one card compete for attention.

## Accessibility

The visual renders a `<div>` with no role and takes no focus. Screen readers skip the artwork.

* **Artwork (aria-hidden):** Decorative, so screen readers skip it.
* **Name the Step in Text (Your task):** The title of the card names the step.

## Related

[Visual](/docs/components/visual)

Use for the illustration at the top of a modal.

[HeroVisual](/docs/components/hero-visual)

Use for the hero card beside a setup flow.
