---
title: "Report"
description: "PDF-style document of paper pages: thumbnails, zoom, Download PDF."
---

> Documentation Index
> Fetch the complete documentation index at: https://gistui.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Report

```gistui
root = Report(Sheet(Header("Annual report", "Fiscal year 2026", size:xl, align:center), layout:center, bg:inverse), Sheet(Header("Summary"), Stats(kpis), Callout("Revenue grew in every region.", tone:success)), title:"Annual report")
kpis = |Label|Value|Delta
|Revenue|$14.2M|+18%
|Margin|61%|+3pt
```

## Signature

This is the line a model reads in the system prompt.

```gistui
Report(...Sheet, title:str, subtitle:str, size:a4|letter)
```

- **Group:** Layout
- **Children:** Yes: Sheet
- **Positional arguments:** none

## Props

| Prop | Type | How to write it | Notes |
|---|---|---|---|
| `title` | string | named: `title:…` |  |
| `subtitle` | string | named: `subtitle:…` |  |
| `size` | `a4` · `letter` | named: `size:…` | Default `"a4"`. |

## Use your own component

Keep the name and schema, swap what is drawn. The prompt and the model's output do not change.

### React

```tsx
import { ui } from "@gistui/react/ui";

const lib = ui.extend({ Report: MyReport });
<GistUI library={lib} stream={response.body} />;
```
### Vue

```vue
<GistUI :source="answer" :components="{ Report: MyReport }" />
```
### Svelte

```svelte
<GistUI source={answer} components={{ Report: MyReport }} />
```
### Solid

```tsx
<GistUI source={answer()} components={{ Report: MyReport }} />
```
### Vanilla

```ts
import { ui } from "@gistui/vanilla/ui";

const lib = ui.extend({ Report: (ctx) => ({ el: myElement(ctx) }) });
```

See [Custom components](/docs/guides/custom-components/) for the full contract. Style hook: `[data-gistui="Report"]`.

Source: https://gistui.com/docs/components/layout/report/index.mdx