# Hero, prompt box

- **[Sections](/blocks/)**
- **[Hero](/blocks/hero/)**
- **Hero, prompt box**

A large dark prompt box with a round send arrow, a row of suggestion chips under it, then a filled button beside a plain link; the two actions stack on a phone.

## Import

- **CLI**

  ```
  npx shadcn add https://ui.klarhimmel.com/r/hero-prompt-box.json
  ```
- **Import**

  ```
  import Block from '@/components/klarhimmel/blocks/hero-prompt-box';
  ```

Also called

- hero/prompt-box

- **Category**: The first screen: what it is, who it is for, what to do next. New project? Set it up once: /get-started/installation.

## Notes

- **When to use it**: A large dark prompt box with a round send arrow, suggestion chips under it, and a filled button beside a plain link. Use it when the product starts from something the visitor types, and `hero-url-form` when it starts from an address.
- **Writing for it**: - Set the box's placeholder as an example of a good request, since it is what the visitor sees before typing.
- Write the chips as real starting points a visitor can pick, three to five of them, in the same voice as the box.
- Point the form action at the page that handles the text, and the form submits natively with its method.
- **Watch out for**: The title is optional here and an emptied one draws no heading, so a page that needs a heading for its outline must keep it. The two actions stack on a phone.

## Pairs well with

- **[Features, grid](/blocks/features/grid)**
- **[Steps, horizontal](/blocks/steps/horizontal)**
- **[Logos strip](/blocks/logo-cloud/row)**

## Usage

The block in a page, with its default content (long lists shortened). Every prop is in the table below.

section.tsx

```
import { Theme } from '@/components/klarhimmel/theme/style';
import { BlockSurface } from '@/components/klarhimmel/blocks/surface';
import HeroPromptBox from '@/components/klarhimmel/blocks/hero-prompt-box';

export default function Section() {
  return (
    <Theme theme="brand">
      <BlockSurface>
        <HeroPromptBox props={{
          "title": "Say what the visitor can make here, in one short line",
          "placeholder": "Ask the visitor the one question they come here to answer",
          "submit": "Send",
          "chips": [
            {
              "label": "First example"
            },
            {
              "label": "Second example"
            },
            {
              "label": "Third example"
            },
            {
              "label": "Fourth example"
            }
          ],
          "primary": {
            "label": "Start for free",
            "href": "#start"
          },
          "secondary": {
            "label": "Learn more",
            "href": "#more"
          }
        }} />
      </BlockSurface>
    </Theme>
  );
}
```

## Props

The type, default and text limit of every prop. On a real page, over-limit text is kept and checkSections flags it (Installation, Check a page before you ship); this live preview shows the default until it fits. The panel above edits all props.

- **title**: Text, up to 80 characters.
- **placeholder**: Text, up to 80 characters.
- **submit**: Text, up to 24 characters.
- **chips**: List of up to 6. Each item: label.
- **primary**: See the type.
- **secondary**: Optional; empty is not rendered.
- **action**: Text, up to 300 characters. Optional; empty is not rendered.
- **method**: One of 'post', 'get'. Optional; empty is not rendered.
- **hidden**: Optional; empty is not rendered.
- **captcha**: Optional; empty is not rendered.
- **captchaSitekey**: Text, up to 100 characters. Optional; empty is not rendered.
- **headingLevel**: One of '1', '2'. Optional; empty is not rendered.

[Previous](/blocks/hero/prompt)

[Next](/blocks/hero/split)
