# App Home 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/composed-components/app-home ## Governing rules [Building with Socra components](https://socra.design/agents.md) explains setup, consumption rules and verification. Semantic owner: Flash Module `ui-component-composition` 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. Keep apps central, with compact account controls and one next step. The host supplies permissions and progress; AppHome owns launcher composition. Status: partial. Real AppHome and launcher AppGrid exports. Published-artifact browser verification is recorded internally. Library: @socra/web-ui ## Anatomy - A named main landmark, or embedded section with scope="component". - Header slots hold the Account and actions. - App content stays bounded; next and footer slots are separate from the app list. ## Properties [Complete public API, including inherited properties and event signatures](https://socra.design/composed-components/app-home/api.md) ### Setup - Use the host-selected compatible Socra theme provider and published component styles. Keep one compatible provider instance across shared packages. ### AppHome Import: `import { AppHome } from '@socra/web-ui/app-home';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `account` | `ReactNode` | Omitted; no declared default | no | | Direct API | | `actions` | `ReactNode` | Omitted; no declared default | no | | Direct API | | `children` | `ReactNode` | Required input | yes | | Direct API | | `footer` | `ReactNode` | Omitted; no declared default | no | | Direct API | | `introduction` | `ReactNode` | Omitted; no declared default | no | | Direct API | | `next` | `ReactNode` | Omitted; no declared default | no | | Direct API | | `scope` | `"document"`, `"component"` | `"document"` | no | Use component scope when composing inside an existing page main landmark. | Direct API | | `title` | `ReactNode` | Required input | yes | | Direct API | ### AppGrid Import: `import { AppGrid } from '@socra/web-ui/app-grid';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `alignment` | `"center"`, `"start"` | `"center"` | no | Align the group, icons and complete labels with surrounding content. Center preserves the existing presentation. Start follows text direction. | Direct API | | `children` | `ReactNode` | Required input | yes | | Direct API | | `itemAlignment` | `"center"`, `"start"` | Omitted; no declared default | no | Align each icon and label independently of the collection. | Direct API | | `label` | `string` | Required input | yes | Names the collection for assistive technology. | Direct API | | `variant` | `"standard"`, `"launcher"`, `"compact-launcher"` | `"standard"` | no | Standard and launcher retain operational state geometry. Compact launcher is icon-first navigation with close, complete labels and centered partial rows. | Direct API | ### AppGridItem Import: `import { AppGridItem } from '@socra/web-ui/app-grid';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `activity` | `"loading"`, `"ready"`, `"unavailable"` | `"ready"` | no | Activity may be pending or unavailable while the app remains usable. | Direct API | | `description` | `string \| undefined` | Omitted; no declared default | no | Brief availability or Account-context guidance; the full text stays accessible. | Direct API | | `disabled` | `false`, `true` | `false` | no | | Direct API | | `href` | `string \| undefined` | Omitted; no declared default | no | The host owns authorization and the destination's Account context. | Direct API | | `icon` | `ReactNode` | Required input | yes | A recognizable, non-interactive app image or glyph. Shared glyphs use size="inherit". | Direct API | | `name` | `string` | Required input | yes | | Direct API | | `unreadCount` | `number \| undefined` | Omitted; no declared default | no | Show only an authorized, current count. Zero and invalid counts are hidden. | Direct API | ### Dialog Import: `import { Dialog } from '@socra/web-ui/dialog';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `actionsRef` | `RefObject \| undefined` | Omitted; no declared default | no | A ref to imperative actions. - \`unmount\`: Manually unmounts the dialog. Call this after any externally controlled closing animation finishes. - \`close\`: Closes the dialog imperatively when called. | Direct API | | `children` | `ReactNode \| PayloadChildRenderFunction` | Omitted; no declared default | no | The content of the dialog. This can be a regular React node or a render function that receives the \`payload\` of the active trigger. | Direct API | | `defaultOpen` | `false`, `true` | `false` | no | Whether the dialog is initially open. To render a controlled dialog, use the \`open\` prop instead. | Direct API | | `defaultTriggerId` | `string \| null \| undefined` | Omitted; no declared default | no | ID of the trigger that the dialog is associated with. This is useful in conjunction with the \`defaultOpen\` prop to create an initially open dialog. | Direct API | | `disablePointerDismissal` | `false`, `true` | `false` | no | Whether to prevent the dialog from closing on outside presses. For non-modal dialogs, this also prevents the dialog from closing when focus moves outside of it. | Direct API | | `handle` | `DialogHandle \| undefined` | Omitted; no declared default | no | A handle to associate the dialog with a trigger. If specified, allows external triggers to control the dialog's open state. Can be created with the Dialog.createHandle() method. | Direct API | | `modal` | `false`, `true`, `"trap-focus"` | `true` | no | Determines if the dialog enters a modal state when open. - \`true\`: user interaction is limited to just the dialog: focus is trapped, document page scroll is locked, and pointer interactions on outside elements are disabled. - \`false\`: user interaction with the rest of the document is allowed. - \`'trap-focus'\`: focus is trapped inside the dialog, but document page scroll is not locked and pointer interactions outside of it remain enabled. When \`modal\` is \`true\` or \`'trap-focus'\`, render \`\` inside \`\` so touch screen readers can escape the popup. | Direct API | | `onOpenChange` | `((open: boolean, eventDetails: DialogRootChangeEventDetails) => void) \| undefined` | Omitted; no declared default | no | Event handler called when the dialog is opened or closed. | Direct API | | `onOpenChangeComplete` | `((open: boolean) => void) \| undefined` | Omitted; no declared default | no | Event handler called after any animations complete when the dialog is opened or closed. | Direct API | | `open` | `false`, `true` | Omitted; no declared default | no | Whether the dialog is currently open. | Direct API | | `triggerId` | `string \| null \| undefined` | Omitted; no declared default | no | ID of the trigger that the dialog is associated with. This is useful in conjunction with the \`open\` prop to create a controlled dialog. There's no need to specify this prop when the dialog is uncontrolled (that is, when the \`open\` prop is not set). | Direct API | ### DialogContent Import: `import { DialogContent } from '@socra/web-ui/dialog';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `className` | `string \| ((state: DialogPopupState) => string \| undefined) \| undefined` | Omitted; no declared default | no | CSS class applied to the element, or a function that returns a class based on the component's state. | Direct API | | `finalFocus` | `boolean \| RefObject \| ((closeType: InteractionType) => boolean \| void \| HTMLElement \| null) \| undefined` | Omitted; no declared default | no | Determines the element to focus when the dialog is closed. - \`false\`: Do not move focus. - \`true\`: Move focus based on the default behavior (trigger or previously focused element). - \`RefObject\`: Move focus to the ref element. - \`function\`: Called with the interaction type (\`mouse\`, \`touch\`, \`pen\`, or \`keyboard\`). Return an element to focus, \`true\` to use the default behavior, \`null\` to fall back to the default behavior, or \`false\`/\`undefined\` to do nothing. | Direct API | | `initialFocus` | `boolean \| RefObject \| ((openType: InteractionType) => boolean \| void \| HTMLElement \| null) \| undefined` | Omitted; no declared default | no | Determines the element to focus when the dialog is opened. By default, focus moves to the first tabbable element inside the popup, except when the dialog is opened by touch — then the popup itself is focused to avoid opening the virtual keyboard. - \`false\`: Do not move focus. - \`true\`: Move focus based on the default behavior (first tabbable element or popup). - \`RefObject\`: Move focus to the ref element. - \`function\`: Called with the interaction type (\`mouse\`, \`touch\`, \`pen\`, or \`keyboard\`). Return an element to focus, \`true\` to use the default behavior, \`null\` to fall back to the default behavior, or \`false\`/\`undefined\` to do nothing. | Direct API | | `render` | `ReactElement> \| ComponentRenderFn \| undefined` | Omitted; no declared default | no | Allows you to replace the component's HTML element with a different tag, or compose it with another component. Accepts a \`ReactElement\` or a function that returns the element to render. | Direct API | | `showCloseButton` | `false`, `true` | `true` | no | | Direct API | | `size` | `"sm"`, `"lg"`, `"md"` | `"sm"` | no | | Direct API | | `style` | `CSSProperties \| ((state: DialogPopupState) => CSSProperties \| undefined) \| undefined` | Omitted; no declared default | no | Style applied to the element, or a function that returns a style object based on the component's state. | Direct API | 275 additional inherited properties are listed in the complete API. The accepted set comes from this export's type; forwarding and overrides follow its documented behavior. ### DialogHeader Import: `import { DialogHeader } from '@socra/web-ui/dialog';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `actions` | `ReactNode` | Omitted; no declared default | no | Owns the header controls at the normal content inset. Pair with DialogContent showCloseButton={false}; include DialogClose when dismissible. | Direct API | 280 additional inherited properties are listed in the complete API. The accepted set comes from this export's type; forwarding and overrides follow its documented behavior. ### DialogTitle Import: `import { DialogTitle } from '@socra/web-ui/dialog';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `className` | `string \| ((state: DialogTitleState) => string \| undefined) \| undefined` | Omitted; no declared default | no | CSS class applied to the element, or a function that returns a class based on the component's state. | Direct API | | `render` | `ReactElement> \| ComponentRenderFn \| undefined` | Omitted; no declared default | no | Allows you to replace the component's HTML element with a different tag, or compose it with another component. Accepts a \`ReactElement\` or a function that returns the element to render. | Direct API | | `style` | `CSSProperties \| ((state: DialogTitleState) => CSSProperties \| undefined) \| undefined` | Omitted; no declared default | no | Style applied to the element, or a function that returns a style object based on the component's state. | Direct API | 275 additional inherited properties are listed in the complete API. The accepted set comes from this export's type; forwarding and overrides follow its documented behavior. ### DialogDescription Import: `import { DialogDescription } from '@socra/web-ui/dialog';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `className` | `string \| ((state: DialogDescriptionState) => string \| undefined) \| undefined` | Omitted; no declared default | no | CSS class applied to the element, or a function that returns a class based on the component's state. | Direct API | | `render` | `ReactElement> \| ComponentRenderFn \| undefined` | Omitted; no declared default | no | Allows you to replace the component's HTML element with a different tag, or compose it with another component. Accepts a \`ReactElement\` or a function that returns the element to render. | Direct API | | `style` | `CSSProperties \| ((state: DialogDescriptionState) => CSSProperties \| undefined) \| undefined` | Omitted; no declared default | no | Style applied to the element, or a function that returns a style object based on the component's state. | Direct API | 275 additional inherited properties are listed in the complete API. The accepted set comes from this export's type; forwarding and overrides follow its documented behavior. ### DialogFooter Import: `import { DialogFooter } from '@socra/web-ui/dialog';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `primaryAction` | `undefined \| ReactNode` | Omitted; no declared default | no | | Direct API | | `secondaryActions` | `undefined \| ReactNode` | Omitted; no declared default | no | | Direct API | | `showCloseButton` | `false`, `true` | `false` | no | | Direct API | 280 additional inherited properties are listed in the complete API. The accepted set comes from this export's type; forwarding and overrides follow its documented behavior. ### TextField Import: `import { TextField } from '@socra/web-ui/field';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `aria-describedby` | `string \| undefined` | Omitted; no declared default | no | | Direct API | | `autoComplete` | `string \| undefined` | Omitted; no declared default | no | | Direct API | | `autoFocus` | `false`, `true` | Omitted; no declared default | no | | Direct API | | `chrome` | `"default"`, `"standard"` | `"default"` | no | | Direct API | | `defaultValue` | `string \| undefined` | Omitted; no declared default | no | | Direct API | | `description` | `string \| undefined` | Omitted; no declared default | no | | Direct API | | `disabled` | `false`, `true` | Omitted; no declared default | no | | Direct API | | `error` | `string \| undefined` | Omitted; no declared default | no | | Direct API | | `id` | `string \| undefined` | Omitted; no declared default | no | | Direct API | | `label` | `string` | Required input | yes | | Direct API | | `max` | `string \| undefined` | Omitted; no declared default | no | | Direct API | | `maxLength` | `number \| undefined` | Omitted; no declared default | no | | Direct API | | `maxRows` | `number \| undefined` | Omitted; no declared default | no | | Direct API | | `min` | `string \| undefined` | Omitted; no declared default | no | | Direct API | | `minRows` | `number \| undefined` | `3` | no | | Direct API | | `multiline` | `false`, `true` | `false` | no | | Direct API | | `name` | `string \| undefined` | Omitted; no declared default | no | | Direct API | | `onBlur` | `(() => void) \| undefined` | Omitted; no declared default | no | | Direct API | | `onValueChange` | `((value: string) => void) \| undefined` | Omitted; no declared default | no | | Direct API | | `placeholder` | `string \| undefined` | Omitted; no declared default | no | | Direct API | | `readOnly` | `false`, `true` | Omitted; no declared default | no | | Direct API | | `required` | `false`, `true` | Omitted; no declared default | no | | Direct API | | `resize` | `"none"`, `"vertical"` | Omitted; no declared default | no | | Direct API | | `size` | `"default"`, `"sm"`, `"lg"` | `"default"` | no | | Direct API | | `step` | `number \| undefined` | Omitted; no declared default | no | | Direct API | | `type` | `HTMLInputTypeAttribute \| undefined` | Omitted; no declared default | no | | Direct API | | `value` | `string \| undefined` | Omitted; no declared default | no | | Direct API | 2 additional inherited properties are listed in the complete API. The accepted set comes from this export's type; forwarding and overrides follow its documented behavior. ### Button Import: `import { Button } from '@socra/web-ui/button';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `className` | `string \| ((state: ButtonState) => string \| undefined) \| undefined` | Omitted; no declared default | no | CSS class applied to the element, or a function that returns a class based on the component's state. | Direct API | | `edge` | `"start"` | Omitted; no declared default | no | Removes the leading padding so a link button's text lines up with its container edge. | Direct API | | `focusableWhenDisabled` | `false`, `true` | `false` | no | Whether the button should be focusable when disabled. | Direct API | | `layer` | `"content"`, `"glass"` | `"content"` | no | | Direct API | | `loading` | `false`, `true` | Omitted; no declared default | no | Blocks re-entry and exposes progress without changing the action's label or width. | Direct API | | `nativeButton` | `false`, `true` | `true` | no | Whether the component renders a native \`