# Integration card

> A connected account: logo, account, status badge, one action.

- Group: Feedback
- Status: stable
- Aliases: connection-card, connected-account
- HTML page: https://design.ipmnx.com/components/integration-card/
- Spec: https://design.ipmnx.com/design/#nx-integration-card

## Preview

**Facebook page**

```html
<section class="nx-card nx-integration nx-integration--connected">
  <div class="nx-card__body nx-integration__body">
    <div class="nx-integration__head">
      <span class="nx-integration__logo" aria-hidden="true">f</span>
      <div class="nx-integration__name">
        <h3 class="nx-card__title">Facebook</h3>
        <p class="nx-integration__account">Page: IPM Facility</p>
      </div>
      <span class="nx-badge nx-badge--success">
        <span class="nx-badge__dot"></span>
        Connected
      </span>
    </div>
    <div class="nx-card__footer">
      <button type="button"
          class="nx-btn nx-btn--ghost">Disconnect</button>
    </div>
  </div>
</section>
```

```tsx
<NxIntegrationCard
  logo="f"
  name="Facebook"
  account="Page: IPM Facility"
  status="connected"
  statusLabel="Connected"
  action={disconnectButton}
/>
```

## API

### React props (NxKit)

| Prop | Type | Default | Required | Description |
| --- | --- | --- | --- | --- |
| `logo` | `ReactNode` |   | yes | Brand mark of the integration (decorative, aria-hidden). |
| `name` | `ReactNode` |   | yes | Integration name. |
| `status` | `"connected" \| "expired" \| "disconnected" \| "error"` |   | yes | Drives the badge variant. |
| `statusLabel` | `string` |   | yes | Localised status text. |
| `account` | `ReactNode` | `undefined` |   | Which account is connected. |
| `description` | `ReactNode` | `undefined` |   | One line under the head: what the integration is used for. |
| `action` | `ReactNode` | `undefined` |   | ONE action in the footer. |
| `error` | `ReactNode` | `undefined` |   | Why it failed (role=alert). |
| `children` | `ReactNode` | `undefined` |   | Extra body content between the description and the error. |

### Classes

| Class | Description |
| --- | --- |
| `.nx-integration` | Card |
| `.nx-integration__body` | Padded body (nx-card__body); footer pinned to the bottom |
| `.nx-card__footer` | Footer actions (new in 0.9) |

## States

### expired

```html
<section class="nx-card nx-integration nx-integration--expired"><div class="nx-card__body nx-integration__body"><div class="nx-integration__head"><span class="nx-integration__logo" aria-hidden="true">in</span><div class="nx-integration__name"><h3 class="nx-card__title">LinkedIn</h3><p class="nx-integration__account">Personal: Alex Berger</p></div><span class="nx-badge nx-badge--warning"><span class="nx-badge__dot"></span>Expired</span></div><div class="nx-card__footer"><button type="button" class="nx-btn nx-btn--primary">Reconnect</button></div></div></section>
```

## Accessibility

- Status is a text badge, never colour alone; errors are role=alert.

## Do / Don't

- Do: Keep all connections on one Accounts page and link there.
- Don't scatter connect buttons across feature pages.

## Related

- [Card](https://design.ipmnx.com/components/card.md)
- [Badge](https://design.ipmnx.com/components/badge.md)

---

Source: registry.js (NX Design System)
