# Page Layout 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/page-layout ## Governing rules [Building with Socra components](https://socra.design/agents.md) explains setup, consumption rules and verification. Semantic owner: Flash Module `ui-component-composition-marketing-shell` 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. One marketing page with shared navigation, content, closing action, and footer. Compose a complete marketing page while keeping its identity, destinations, and content owned by the consumer. Status: ready. MarketingShell owns the page regions and the band sequence. The specimen renders the public shell, optional MarketingAnnouncement, one main BandStack, a closing action, and the shared footer; its bands alternate base and surface by position and meet at the divider. Site Header remains the separate navigation-only home; application headers remain in Composed Components → Headers. Library: @socra/ui-web-landing ## Anatomy - The shared header leads, followed by an optional consequential announcement that scrolls with the page. - One main landmark contains the content stack and optional closing action; the footer follows it. - The main landmark carries the band sequence: by position, its sections alternate base and surface and every boundary after the first carries the divider, through the closing action. Pages set neither. - A surrounding host may supply its own SiteHeader and set header={null} on MarketingShell to avoid duplicate navigation. ## States - **Rest:** Render the consumer’s content in one continuous page. The optional announcement and closing action do not create additional main landmarks. - **Focus:** Nested navigation and actions retain their shared visible keyboard focus, reading order, and dismissal behavior. The page frame itself is not a control. ## Motion The page layout adds no motion. The header and nested controls retain their own reduced-motion contracts. ## Properties [Complete public API, including inherited properties and event signatures](https://socra.design/landing/page-layout/api.md) ### Setup - Use the host-selected compatible Socra theme provider and published component styles. Keep one compatible provider instance across shared packages. ### MarketingShell Import: `import { MarketingShell } from '@socra/ui-web-landing';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `announcement` | `ReactNode` | Omitted; no declared default | no | A property-owned notice rendered above the header, for the rare case where a visitor would otherwise hit a dead end, such as a product that moved hosts. It is not a marketing slot. | Direct API | | `brandHref` | `string \| undefined` | `"/"` | no | The property-owned brand destination. | Direct API | | `brandLabel` | `ReactNode` | Required input | yes | The property-owned label beside the shared Socra mark. | Direct API | | `brandMark` | `ReactNode` | Omitted; no declared default | no | Shared product identity artwork. | Direct API | | `children` | `ReactNode` | Required input | yes | Page-specific content between the global header and footer. | Direct API | | `closingCta` | `MarketingClosingCtaProps \| undefined` | Omitted; no declared default | no | Page-owned content for the shared closing section above the footer. | Direct API | | `companyHref` | `string \| undefined` | `'https://socra.com'` | no | The company destination carried by the Socra mark. | Direct API | | `footerBrandHref` | `string \| undefined` | Omitted; no declared default | no | Footer lockup destination when it differs from the property destination. | Direct API | | `footerBrandLabel` | `ReactNode` | Omitted; no declared default | no | Footer lockup label when it differs from the property label. | Direct API | | `footerBrandMark` | `ReactNode` | Omitted; no declared default | no | Property artwork in the footer, independent of the company navigation mark. | Direct API | | `footerCopyright` | `ReactNode` | Omitted; no declared default | no | Copyright line shown in the footer utility row. | Direct API | | `footerGroups` | `readonly MarketingFooterGroup[] \| undefined` | `[]` | no | Property-owned footer groups, including every header destination. | Direct API | | `footerLegal` | `readonly MarketingFooterLink[] \| undefined` | Omitted; no declared default | no | Utility-row destinations rendered against the copyright. | Direct API | | `footerLocale` | `ReactNode` | Omitted; no declared default | no | Optional property-owned locale shown in the footer utility row. | Direct API | | `header` | `ReactNode` | Omitted; no declared default | no | Shared header supplied by the host; null when a surrounding shell already owns it. | Direct API | | `items` | `readonly SiteHeaderItem[]` | Required input | yes | Property-owned navigation, including an explicitly empty navigation. | Direct API | | `linkComponent` | `ElementType \| undefined` | Omitted; no declared default | no | Anchor-compatible host router adapter, shared by header and footer. | Direct API | | `primaryAction` | `SiteHeaderAction \| undefined` | Omitted; no declared default | no | New-user action. | Direct API | | `secondaryAction` | `SiteHeaderLoginAction \| undefined` | Omitted; no declared default | no | Returning-user action. | Direct API | | `showFooterTagline` | `false`, `true` | `true` | no | Show the canonical company signature in the footer. | Direct API | ### MarketingAnnouncement Import: `import { MarketingAnnouncement } from '@socra/ui-web-landing';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `action` | `ReactNode` | Omitted; no declared default | no | The link's label. Names where it goes, never "Learn more". | Direct API | | `children` | `ReactNode` | Required input | yes | The notice itself, stated plainly. | Direct API | | `href` | `string \| undefined` | Omitted; no declared default | no | The destination that resolves the notice. | Direct API | | `linkComponent` | `ElementType \| undefined` | `"a"` | no | Consumer router link element. | Direct API | ### MarketingClosingCta Import: `import { MarketingClosingCta } from '@socra/ui-web-landing';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `action` | `MarketingClosingCtaAction` | Required input | yes | Page-owned action, rendered with the shared primary treatment. | Direct API | | `description` | `string` | Required input | yes | Page-owned explanation of that promise. | Direct API | | `headingId` | `string \| undefined` | `"marketing-closing-cta-title"` | no | Stable heading id when the page needs an anchor of its own. | Direct API | | `headingTreatment` | `"solid"`, `"gradient"` | `'gradient'` | no | The heading paint treatment. | Direct API | | `id` | `string \| undefined` | Omitted; no declared default | no | Optional page anchor placed on the complete section. | Direct API | | `link` | `Pick \| undefined` | Omitted; no declared default | no | A quiet text link beneath the actions, for another way to start that does not compete with them, such as \`Or open Channels in your browser\`. | Direct API | | `primaryPlacement` | `"first"`, `"last"` | Omitted; no declared default | no | Primary position in reading and keyboard order. Defaults to first for an equal pair, last otherwise. | Direct API | | `secondaryAction` | `MarketingClosingCtaAction \| undefined` | Omitted; no declared default | no | Optional secondary discovery action. | Direct API | | `secondaryVariant` | `"link"`, `"outline"` | Omitted; no declared default | no | Shared secondary action treatment. Defaults to outline for every secondary CTA. | Direct API | | `sizing` | `"content"`, `"equal"` | `"content"` | no | Match a pair of action dimensions using the shared marketing sizing contract. | Direct API | | `title` | `ReactNode` | Required input | yes | Page-owned closing promise. | Direct API | ### MarketingFooter Import: `import { MarketingFooter } from '@socra/ui-web-landing';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `brandHref` | `string \| undefined` | `"/"` | no | Destination of the footer brand lockup. | Direct API | | `brandLabel` | `ReactNode` | Omitted; no declared default | no | Property-owned label beside the shared Socra mark. | Direct API | | `brandMark` | `ReactNode` | Omitted; no declared default | no | Shared product identity artwork. | Direct API | | `copyright` | `ReactNode` | Omitted; no declared default | no | Copyright line. Defaults to the current year against the Socra name. | Direct API | | `groups` | `readonly MarketingFooterGroup[] \| undefined` | `[]` | no | The titled groups, in reading order. | Direct API | | `legal` | `readonly MarketingFooterLink[] \| undefined` | `[]` | no | The utility-row destinations rendered against the copyright. | Direct API | | `linkComponent` | `ElementType \| undefined` | `"a"` | no | Consumer router link element. | Direct API | | `locale` | `ReactNode` | Omitted; no declared default | no | Optional property-owned locale shown in the utility row. | Direct API | | `showTagline` | `false`, `true` | `true` | no | Show the canonical company signature. Omit it when the page needs only its identity. | Direct API | ### SiteHeader Import: `import { SiteHeader } from '@socra/ui-web-landing';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `appearance` | `"company"`, `"product"` | Omitted; no declared default | no | Preserves the company glass or product service-catalog presentation. | Direct API | | `brand` | `ReactNode` | Omitted; no declared default | no | A property-owned wordmark node rendered beside the Socra mark. | Direct API | | `brandHref` | `string \| undefined` | `'/'` | no | Where the property wordmark links. | Direct API | | `brandLabel` | `ReactNode` | Omitted; no declared default | no | A property-owned label rendered in the canonical Socra lockup. | Direct API | | `brandMark` | `ReactNode` | Omitted; no declared default | no | Product-owned identity artwork. | Direct API | | `companyHref` | `string \| undefined` | `'https://socra.com'` | no | The company destination carried by the Socra mark. | Direct API | | `hideOnScroll` | `false`, `true`, `"mobile"` | Omitted; no declared default | no | Hide down and reveal up on all screens, compact screens only, or never. Defaults to true. | Direct API | | `items` | `readonly SiteHeaderItem[]` | Required input | yes | The top-level tabs, in order. | Direct API | | `linkComponent` | `ElementType \| undefined` | `"a"` | no | Anchor-compatible host router adapter. Defaults to a native anchor. | Direct API | | `primaryAction` | `SiteHeaderAction \| undefined` | Omitted; no declared default | no | The new-user action, rendered as the filled squircle. | Direct API | | `secondaryAction` | `SiteHeaderLoginAction \| undefined` | Omitted; no declared default | no | The canonical filled-secondary Log in action. | Direct API | | `skipToContent` | `false`, `true` | Omitted; no declared default | no | Disable when the containing page shell already owns its bypass link. | Direct API | ### BandStack Import: `import { BandStack } from '@socra/ui-web-landing';` | Property | Type or permitted values | Default / omission | Required | Meaning and behavior | Inspector | | --- | --- | --- | --- | --- | --- | | `children` | `ReactNode` | Required input | yes | The page's major surfaces, in reading order. | Direct API | | `component` | `"div"`, `"main"` | Omitted; no declared default | no | The element a standalone stack renders. A marketing page's band stack IS its main content, so it renders \`main\` unless this says \`div\`. Inside a shell that already renders \`main\` the stack renders no element of its own. | 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 - MarketingShell owns main, optional header/footer/closing action and automatic band sequencing. header undefined uses shared header; header null delegates the header to the host. ### Inspector mappings | Setting | Initial preview value | Consumed code | | --- | --- | --- | | Migration announcement | `false` | composition: Include MarketingAnnouncement in the announcement slot. | | Closing action | `true` | composition: Include or omit closingCta content. | | Closing text link | `false` | derived: On passes closingCta.link ({ label, href, ariaLabel? }), a quiet MarketingTextLink centered beneath the closing actions; off omits it. | | Header owned by surrounding host | `false` | composition: Render a host SiteHeader and pass header=null to MarketingShell, avoiding duplicate headers. | ## Example ```tsx import { Band, BandIntro, BandStack, MarketingAnnouncement, MarketingShell } from '@socra/ui-web-landing'; Product has moved to product.example. } closingCta={{ title: 'Take the next step', description: 'Explore how Product fits the work you want to do.', headingTreatment: 'solid', action: { label: 'Explore the overview', href: '#overview' } }} footerGroups={[{ id: 'product', heading: 'Product', links: [{ label: 'Overview', href: '#overview' }] }]} > ```