# Hero

> A centered marketing hero — a release badge, serif headline, supporting copy, and primary/secondary calls to action.

A shadcn/ui block from the [@quill](https://www.quilldesignsystem.com) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/quill/hero).

- Page, with a live preview: https://shadcn.exchange/r/quill/hero
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/quill/hero-light-bfacee766b47e080.png
- Registry item: https://www.quilldesignsystem.com/r/hero.json
- Categories: marketing
- Listed: 2026-10-13, source last changed 2026-10-13

## Install

```bash
npx shadcn@latest add https://www.quilldesignsystem.com/r/hero.json
```

Run it in a project that has shadcn/ui set up. It adds the files below and installs what they depend on.

## Dependencies

- Registry items: `badge`, `button`, `https://www.quilldesignsystem.com/r/icon.json`

## Notes from the registry

A centered marketing hero — a release badge, serif headline, supporting copy, and primary/secondary calls to action. Do: Keep exactly one primary (default-variant) button — the single most important action — with any secondary action as outline/ghost. Don't: Give two calls-to-action equal visual weight; competing primaries dilute the one action that matters most. Use feature-section when you're past the opening statement and need to break down specific product capabilities. Use announcement-banner when the message is a small, dismissible update, not the page's primary opening statement.

## Files

### `registry/blocks/hero.tsx`

```tsx
import { Button } from '@/components/ui/button'
import { Badge } from '@/components/ui/badge'
import { Icon } from '@/components/ui/icon'

/** A centered marketing hero — a release badge, serif headline, supporting copy, and primary/secondary calls to action. */
export function Hero() {
  return (
    <section className="flex w-full flex-col items-center gap-6 bg-background px-6 py-20 text-center">
      <Badge variant="secondary">New — v2.0 is here</Badge>
      <h1 className="max-w-2xl font-heading text-5xl leading-display text-balance">
        The calm design system for building things by hand
      </h1>
      <p className="max-w-xl text-base text-pretty text-muted-foreground">
        Accessible, themeable components and a single-source token foundation that flows to code
        and design files alike.
      </p>
      <div className="flex flex-wrap items-center justify-center gap-3">
        <Button size="lg">
          Get started <Icon name="arrow_forward" size={18} />
        </Button>
        <Button size="lg" variant="outline">
          <Icon name="menu_book" size={18} /> Read the docs
        </Button>
      </div>
    </section>
  )
}
```