# Brand

URL: /code/file-conventions/brand · Id: `page:code/file-conventions/brand`

> The brand folder holds the Brand, its Theme tokens and the Templates every Message, Document and Page is built from.

The `brand/` folder holds the [Brand](/business/nouns/brand), its [Theme](/business/nouns/theme) and the [Templates](/business/nouns/template) every [Message](/business/nouns/message), [Document](/business/nouns/document) and [Page](/business/nouns/page) is built from.

```text
brand/
├── index.mdx                       name, voice, logo
├── theme.mdx                       tokens: color, type, spacing, radius, motion
└── templates/renewal-notice.mdx    a Template for one Message
```

## Reference
| [File](/business/nouns/file) | Frontmatter | Body |
| --- | --- | --- |
| `index.mdx` | `name`, `voice`, `logo` | How the Brand speaks |
| `theme.mdx` | `tokens`, with `light` and `dark` values | None |
| `templates/[name].mdx` | `kind`: `message`, `document` or `page`; `subject` | The Template, with `{variables}` read from records |

## Examples
### Minimal
```mdx title="brand/index.mdx"
---
name: Leaseline
voice: Plain and calm.
---
```

### Leaseline
`brand/templates/renewal-notice.mdx`:

```mdx title="brand/templates/renewal-notice.mdx"
---
kind: message
subject: Your lease at {lease.unit} ends on {lease.endsOn}
---
Hi {lease.resident.firstName},

Your lease ends on {lease.endsOn}. The rent from then is {lease.newRent}.
Reply to this email to renew, or tell us what you need.
```

## What it builds
The [SiteBuilder](/code/builders/site) compiles the folder.

- `Brand`, `Theme` and `Template` [Versions](/business/nouns/version)
- a Template edit reaches everything built from it at the next send or publish

## Good to know
- New markup or CSS enters only as a new [Component](/business/nouns/component) or Theme. See [Components](/code/file-conventions/components).