# Connection Card Agents: start with [Workspace for Agents](https://workspace.socra.com/solutions/agents.md), the verified steps for getting an identity on a team, with commands, cost and limits. Socra: Fill the roles your team needs with proactive AI teammates, each with its own computer, identity and role. Canonical: https://socra.design/landing/visuals/connection-card ## Governing rules [Building with Socra components](https://socra.design/agents.md) explains setup, consumption rules and verification. Semantic owner: Flash Module `ui-component-family-content` in Socra Cortex when available. It supplies current intent and prerequisite rules; the public API below supplies exact code names and values. Use published property names, not inspector labels. Composition and preview settings are not component props. Public styling escape hatches do not permit product-local presentation overrides. A team’s AI connections as Admin lists them: provider, runtime and state. Show that a team brings the subscription it already pays for: each connection as Admin’s Connections list shows it, the provider’s mark and name, the runtime it serves and its connected state. The page passes the providers; the card owns Admin’s anatomy and shows no portraits, count or footer, because Admin shows none. Status: ready. Shared connection card (landing.ConnectionCard — Web UI Card titled Connections, with no line beneath the title, and an ItemGroup of connection rows: the provider’s own ProviderMark at 28px, its name as Admin names it, the runtime it serves as the description and the Connected sm Chip with the success check; inert and described in one accessible label) lives in @socra/ui-web-landing. Library: @socra/ui-web-landing ## Properties [Complete public API, including inherited properties and event signatures](https://socra.design/landing/visuals/connection-card/api.md) ### Setup - Use the host-selected compatible Socra theme provider and published component styles. Keep one compatible provider instance across shared packages. ### ConnectionCard Import: `import { ConnectionCard } from '@socra/ui-web-landing';` A team’s AI connections as Admin’s Connections list shows them: each provider’s own mark and name, the runtime it serves and its connected state. | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `connections` | `readonly ConnectionCardConnection[]` | Required input | yes | The connections in the order the page shows them, each a provider of chatgpt or claude. Each renders as an Item row with the ProviderMark at 28px, the provider’s name as Admin names it (ChatGPT, Claude), the runtime it serves as the description (Codex, Claude Code) and a Connected sm Chip with the success check. The card shows no portraits, no count and no footer, because Admin’s list shows none. | Direct API | | `label` | `string` | Required input | yes | What the card is, leading its accessible description. | Direct API | ### Band Import: `import { Band } from '@socra/ui-web-landing';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `ariaLabelledby` | `string \| undefined` | Omitted; no declared default | no | id of the band's heading — keeps the
named for screen readers. | Direct API | | `bleed` | `false`, `true` | `false` | no | Band owns its full width (carousels): children render edge-to-edge with no content column. The child then re-creates the column where it needs one. | Direct API | | `children` | `ReactNode` | Required input | yes | | Direct API | | `colorMode` | `"dark"`, `"ambient"` | `"ambient"` | no | whether the band is fixed dark or follows the ambient page theme. | Direct API | | `contentMaxWidth` | `string \| undefined` | `"1120px"` | no | content column width; the production landing column. | Direct API | | `divider` | `false`, `true` | `false` | no | The divider at a standalone band's leading edge. Inside a marketing page the band sequence puts the divider on every boundary, so pages do not set it. | Direct API | | `id` | `string \| undefined` | Omitted; no declared default | no | anchor id for in-page navigation. | Direct API | | `spacing` | `"none"`, `"compact"`, `"screen"`, `"regular"` | `"regular"` | no | the band's vertical rhythm. | Direct API | | `tone` | `"base"`, `"surface"`, `"raised"` | `"base"` | no | A standalone band's surface step. Inside a marketing page the band sequence alternates base and surface by position, so pages do not set it. | Direct API | ### BandIntro Import: `import { BandIntro } from '@socra/ui-web-landing';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `align` | `"center"`, `"responsive"` | `"responsive"` | no | whether the column centers at every width or only from \`md\`. | Direct API | | `brand` | `ReactNode` | Omitted; no declared default | no | Optional product lockup above the heading. | Direct API | | `children` | `ReactNode` | Omitted; no declared default | no | extra intro content below the description (a second paragraph, a CTA). | Direct API | | `description` | `string \| undefined` | Omitted; no declared default | no | optional standfirst under the heading (\`subhead\` role). | Direct API | | `descriptionTone` | `"secondary"`, `"primary"` | `"primary"` | no | Supporting copy emphasis. | Direct API | | `headingScale` | `"section"`, `"statement"` | `'section'` | no | the heading scale. | Direct API | | `headingTreatment` | `"solid"`, `"gradient"` | `'gradient'` | no | the heading paint treatment. | Direct API | | `id` | `string \| undefined` | Omitted; no declared default | no | heading id — the target of the owning band's \`ariaLabelledby\`. | Direct API | | `level` | `"h1"`, `"h2"` | `'h2'` | no | the heading level; the page's first band passes 'h1'. | Direct API | | `title` | `ReactNode` | Required input | yes | the band heading, rendered through . | Direct API | ### Behavior and constraints - ConnectionCardConnection, ConnectionCardProvider and ConnectionCardProps are public type exports. Every connection renders connected; the component exposes no connecting, reconnect or failed state. - The card is inert and described in one role="img" label that names each provider, its runtime and its connected state. Who shares a connection and that its allowance is shared belong to the page’s words beside the card, not to the card. ### Inspector mappings | Setting | Initial preview value | Consumed code | | --- | --- | --- | | Connections | `both` | composition: Selects which of the two connections to pass as ConnectionCard.connections: both, only ChatGPT or only Claude. It does not supply a provider property. |