# Hero

Landing hero section with optional logos, title, subtitle, CTA buttons, and tech logos footer. Supports image or text logos with separator.

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown variants are available by appending `.md` to any URL or sending an `Accept: text/markdown` header. An agent skill is available at [/.well-known/agent-skills/site-skill.md](/.well-known/agent-skills/site-skill.md).



<ComponentPreview name="hero" src="examples/hero-demo.tsx" />

## Installation [#installation]

<CodeTabs>
  <TabsList>
    <TabsTrigger value="cli">
      Command
    </TabsTrigger>

    <TabsTrigger value="manual">
      Manual
    </TabsTrigger>
  </TabsList>

  <TabsContent value="cli">
    ```bash
    npx shadcn@latest add @mcpcn/hero
    ```
  </TabsContent>

  <TabsContent value="manual">
    <Steps className="mb-0 pt-2">
      <Step>
        Install the component dependencies:
      </Step>

      ```bash
      npm install lucide-react
      ```

      <Step>
        Copy and paste the component into your project.
      </Step>

      <ComponentSource name="hero" title="components/ui/hero.tsx" />

      <Step>
        Update the import paths to match your project setup.
      </Step>
    </Steps>
  </TabsContent>
</CodeTabs>

## Usage [#usage]

```tsx
import {
  Hero,
  HeroActions,
  HeroContent,
  HeroDescription,
  HeroLogos,
  HeroTechLogos,
  HeroTitle,
} from "@/components/ui/hero";
```

```tsx
<Hero>
  <HeroContent>
    <HeroLogos />
    <HeroTitle />
    <HeroDescription />
    <HeroActions />
    <HeroTechLogos />
  </HeroContent>
</Hero>
```

## Composition [#composition]

Use the following composition to build an `Hero`:

```text
Hero
├── HeroActions
├── HeroContent
├── HeroDescription
├── HeroLogos
├── HeroTechLogos
└── HeroTitle
```

## Examples [#examples]

### Two Logos [#two-logos]

<ComponentPreview name="hero-two-logos" src="examples/hero-two-logos-demo.tsx" />

### With Tech Logos [#with-tech-logos]

<ComponentPreview name="hero-tech-logos" src="examples/hero-tech-logos-demo.tsx" />

### Minimal [#minimal]

<ComponentPreview name="hero-minimal" src="examples/hero-minimal-demo.tsx" />

## OpenUI Integration [#openui-integration]

Install the OpenUI React packages.

```bash
pnpm add @openuidev/react-lang zod
```

Add `Hero` to a component library and map it to the installed component.

```tsx showLineNumbers
import { createLibrary, defineComponent } from "@openuidev/react-lang";
import { z } from "zod/v4";

import {
  Hero,
  HeroActions,
  HeroContent,
  HeroDescription,
  HeroLogos,
  HeroTechLogos,
  HeroTitle,
} from "@/components/ui/hero";

const OpenUIHero = defineComponent({
  name: "Hero",
  description:
    "Landing hero section with optional logos, title, subtitle, CTA buttons, and tech logos footer. Supports image or text logos with separator.",
  props: z.object({}),
  component: () => (
    <Hero>
      <HeroContent>
        <HeroLogos />
        <HeroTitle />
        <HeroDescription />
        <HeroActions />
        <HeroTechLogos />
      </HeroContent>
    </Hero>
  ),
});

export const heroLibrary = createLibrary({
  root: "Hero",
  components: [OpenUIHero],
});
```

For richer generated compositions, define the child primitives separately and connect them with `.ref` fields. See [Defining Components](https://www.openui.com/docs/openui-lang/defining-components) in the OpenUI documentation.

## json-render Integration [#json-render-integration]

Install the json-render React packages.

```bash
pnpm add @json-render/core @json-render/react zod
```

Add `Hero` to a component catalog and map it to the installed component.

```tsx
import { defineCatalog } from "@json-render/core";
import { defineRegistry } from "@json-render/react";
import { schema } from "@json-render/react/schema";
import { z } from "zod";

import {
  Hero,
  HeroActions,
  HeroContent,
  HeroDescription,
  HeroLogos,
  HeroTechLogos,
  HeroTitle,
} from "@/components/ui/hero";

export const catalog = defineCatalog(schema, {
  components: {
    Hero: {
      props: z.object({}),
      description:
        "Landing hero section with optional logos, title, subtitle, CTA buttons, and tech logos footer. Supports image or text logos with separator.",
    },
  },
});

export const { registry } = defineRegistry(catalog, {
  components: {
    Hero: () => (
      <Hero>
        <HeroContent>
          <HeroLogos />
          <HeroTitle />
          <HeroDescription />
          <HeroActions />
          <HeroTechLogos />
        </HeroContent>
      </Hero>
    ),
  },
});
```

Use `catalog.prompt()` to constrain model output, then render the generated spec with the json-render React `Renderer`. See the [json-render Quick Start](https://json-render.dev/docs/quick-start) for the provider and streaming setup.

## API Reference [#api-reference]

See the [Base UI](https://base-ui.com/react/overview/quick-start) documentation for more information.