---
title: "Sheet"
description: "One report page; any content."
---

> 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.

# Sheet

```gistui
root = Report(Sheet(Header("Cover page", "A report is made of sheets", size:lg, align:center), layout:center, bg:accent), title:"One sheet")
```

A `Sheet` is only valid inside `Report`.

## Signature

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

```gistui
Sheet(...children, layout:top|center|split, bg:plain|inverse|accent|gradient, image:str)
```

- **Group:** Layout
- **Children:** Yes: any component or text
- **Positional arguments:** none

## Props

| Prop | Type | How to write it | Notes |
|---|---|---|---|
| `layout` | `top` · `center` · `split` | named: `layout:…` |  |
| `bg` | `plain` · `inverse` · `accent` · `gradient` | named: `bg:…` |  |
| `image` | string (URL) | named: `image:…` | background photo URL (cover pages) |

## 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({ Sheet: MySheet });
<GistUI library={lib} stream={response.body} />;
```
### Vue

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

```svelte
<GistUI source={answer} components={{ Sheet: MySheet }} />
```
### Solid

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

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

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

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

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