# Design system

Your organization can keep one `DESIGN.md`: a file with your brand's colors, fonts, spacing and rules.
Every bot follows it when it makes something people will look at, so you don't have to restyle each
page or document yourself.

## Where bots use it

Before a bot makes a [page](/docs/pages/), document, presentation, chart, image or email, it reads your
`DESIGN.md` and follows it. To get something in another style, just ask for it in the chat.

## Who can change it

Owners and admins open **Settings → Design** on web, the desktop app or mobile. On your own account,
that's you. On a [team](/docs/teams/), members don't see **Design** and bots won't save a design system
for them, but their bots still follow it.

## Create one

In **Settings → Design**, choose:

- **Create with a bot**: enter your **Website** and pick a bot under **Choose a bot**. Its chat opens
  with a request already written. Attach brand guidelines, documents or presentations there too, then
  send it. The bot reads your site and files, shows you a summary, and saves it once you approve.
- **Upload DESIGN.md**: pick a file you already have.
- **Write**: start from a template and fill it in. On web and the desktop app only.

You can also just ask a bot in its chat, for example "make our design system from our website". The
bot can save it only in a chat you started, not from a routine or a chat app.

## Change it

Once saved, **Settings → Design** shows its name, color swatches and fonts.

- **Update with a bot** opens a bot's chat with a request to update it. The bot shows what it would
  change and asks before it saves.
- **Edit** changes the text directly, on web and the desktop app.
- In the **More** menu (**...**): **Upload DESIGN.md** replaces it, **Download** saves a copy and
  **Remove** deletes it. On mobile, **Upload DESIGN.md** and **Remove** are on the screen.

Each save is checked first. If something is wrong, such as a color that isn't valid, you see **This
DESIGN.md has problems:** with a list of what to fix, and nothing is saved. On web and the desktop
app, a rejected upload opens in the editor so you can fix it there.

A bot always asks before it saves a design system, whatever your [approval](/docs/approvals/) mode, and
the card offers only **Allow once** or **Deny**.
