# Product Loading 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/product-loading ## Governing rules [Building with Socra components](https://socra.design/agents.md) explains setup, consumption rules and verification. Semantic owner: Flash Module `ui-component-composition-product-loading` 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 product identity centered while an application initializes. Give first paint and startup one quiet identity, with recovery available if initialization stalls. Status: ready. The specimen renders the published ProductLoading export. The viewport presentation runs in its own document; Contained uses the same composition inside the catalog canvas. Library: @socra/web-ui ## Anatomy - The canonical product mark stays centered in the application viewport or contained region. - A named status announces loading without adding a visible message or task. - An optional native recovery link appears after 15 seconds without moving the mark. The link works before client initialization. ## States - **Loading:** A restrained opacity pulse signals progress. Reduced motion leaves the mark still. - **Focus:** The recovery link enters keyboard order only once it becomes visible. - **Error:** The host replaces loading with its persistent failure and recovery UI when initialization fails. ## Motion The mark changes opacity without translation or scale. The system reduced-motion preference stops the pulse while keeping the loading status and delayed recovery available. ## Usage - Use the shared stylesheet from first paint. The server and application must agree on centering and appearance before hydration. - Keep recovery destinations useful. A native link remains usable when the application has not initialized. ## Properties [Complete public API, including inherited properties and event signatures](https://socra.design/composed-components/product-loading/api.md) ### Setup - Use the host-selected compatible Socra theme provider and published component styles. Keep one compatible provider instance across shared packages. ### ProductLoading Import: `import { ProductLoading } from '@socra/web-ui/product-loading';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `assetBaseUrl` | `string \| undefined` | Omitted; no declared default | no | Canonical hosted assets are the default; native shells can serve the same assets locally. | Direct API | | `label` | `string \| undefined` | `"Loading"` | no | The status is announced without adding a second visible loading message. | Direct API | | `presentation` | `"contained"`, `"viewport"` | `"viewport"` | no | Embedded application surfaces keep the same composition inside their own viewport. | Presentation | | `product` | `"id"`, `"email"`, `"mail"`, `"cloud"`, `"fab"`, `"workspace"`, `"admin"`, `"channels"`, `"agents"`, `"cortex"`, `"tasks"`, `"drive"`, `"journeys"`, `"cloud-console"`, `"account"`, `"cli"`, `"design"`, `"growth"`, `"semdag"`, `"support"` | Required input | yes | | Direct API | | `recoveryHref` | `string \| undefined` | Omitted; no declared default | no | A native link becomes available after a prolonged load, including before hydration. | Direct API | | `recoveryLabel` | `string \| undefined` | `"Reload"` | no | | Direct API | ### Behavior and constraints - ProductLoadingSpecimen is a catalog adapter around the public ProductLoading. Host product/mark/label content remains explicit; preview uses neutral Product copy with the company mark. Recovery link becomes visible after the public delay. ### Inspector mappings | Setting | Initial preview value | Consumed code | | --- | --- | --- | | Presentation | `viewport` | ProductLoading.presentation | | Recovery after 15 seconds | `false` | composition: Supply or omit the real recoveryHref to reload the corresponding preview after the public delay. | ## Example ```tsx import { ProductLoading } from '@socra/web-ui/product-loading'; import '@socra/web-ui/product-loading.css'; ```