# Download, desktop builds

- **[Sections](/blocks/)**
- **[Download](/blocks/download/)**
- **Download, desktop builds**

Desktop builds side by side: one card per platform with version, what it runs on, size and a download link that names its platform, then the system requirements for…

## Import

- **CLI**

  ```
  npx shadcn add https://ui.klarhimmel.com/r/download-desktop.json
  ```
- **Import**

  ```
  import Block from '@/components/klarhimmel/blocks/download-desktop';
  ```

Also called

- download/desktop

- **About**: Desktop builds side by side: one card per platform with version, what it runs on, size and a download link that names its platform, then the system requirements for each platform as definition lists.
- **Category**: Get the app: store links with a QR code, or desktop builds with system requirements. New project? Set it up once: /get-started/installation.

## Notes

- **When to use it**: Desktop installers side by side with version, size and system requirements for each platform. For a phone app with store buttons, use `download-apps`.
- **Writing for it**: - Every platform is offered and nothing is detected, so a visitor can pick any build. Take two to four builds.
- Requirements are listed per platform in the same order as the builds. If the orders differ, a card gets the wrong list.
- Version and size are plain text you keep current. The optional line at the end is the place to say how to verify a file.
- **Watch out for**: Each download link names its platform for screen readers after the shared label. A link to a missing file is worse than no card, so remove a platform you stop shipping.

## Pairs well with

- **[Hero, minimal](/blocks/hero/minimal)**
- **[Download, mobile app](/blocks/download/apps)**
- **[FAQ, with a support card](/blocks/faq/support)**

## 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 DownloadDesktop from '@/components/klarhimmel/blocks/download-desktop';

export default function Section() {
  return (
    <Theme theme="brand">
      <BlockSurface>
        <DownloadDesktop props={{
          "eyebrow": "Name the topic",
          "title": "Say what they can download for a computer",
          "description": "Say in one sentence which systems it runs on and how to pick one.",
          "builds": [
            {
              "platform": "First system",
              "version": "2.4.1",
              "detail": "Say which editions it covers",
              "size": "00 MB",
              "href": "#mac"
            }
          ],
          "downloadLabel": "Main action",
          "requirementsTitle": "Name what the system needs",
          "requirements": [
            {
              "platform": "First system",
              "rows": [
                {
                  "label": "First need",
                  "value": "Name the oldest version"
                }
              ]
            }
          ],
          "checksum": "Say that each file is signed and where the checksums are listed for checking."
        }} />
      </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.

- **eyebrow**: Text, up to 60 characters.
- **title**: Text, up to 120 characters.
- **description**: Text, up to 300 characters.
- **builds**: List of 2 to 4. Each item: platform, version, detail, size, href.
- **downloadLabel**: Text, up to 30 characters.
- **requirementsTitle**: Text, up to 60 characters.
- **requirements**: List of 2 to 4. Each item: platform, rows.
- **checksum**: Text, up to 160 characters. Optional; empty is not rendered.
- **headingLevel**: One of '1', '2'. Optional; empty is not rendered.

[Previous](/blocks/download/apps)

[Next](/blocks/changelog/compact)
