Add a _config.md to the folder to control how the whole site looks and
what it is called.
title: Acme Handbook
description: How we work, written down.
author: Acme
theme: forest
logo: 📗
accent: #2f6f4f
You do not have to hand-write this. In the dashboard, open the collection and press Site settings — the same fields as a form, with live theme swatches and a colour picker. Editing there preserves any notes and any keys it does not manage.
The settings#
| Key | What it does |
|---|---|
title | Site name in the header, the sidebar and share previews. Defaults to the folder name |
description | One-line summary under the title, and in search results |
author | Default author for pages that do not set their own |
image | A share image for the site. Overrides the generated card |
theme | A colour preset — see below |
logo | An image URL, or a short word or emoji, shown beside the title |
accent | Your brand colour, used for links and the current-page marker |
Themes#
Five choices: leave theme out for the default, or use sepia,
forest, ocean or mono. An unrecognised name falls back to the
default rather than breaking anything.
Logo#
If the value starts with http:// or https:// it is used as an image.
Anything else is treated as text — a word or an emoji, up to 40
characters. logo: 🧶 and logo: ACME both work.
Accent#
A plain hex colour: #2f6f4f, #2f6, or with an alpha channel. Anything
that is not a hex colour is ignored — this is deliberate, so nothing else
can be injected into the page's styling.
Anything below is ignored#
Only the leading key: value block is read. Once a line stops looking
like a setting, the rest of the file is treated as notes:
title: Acme Handbook
theme: forest
Reviewed each quarter. Ask Priya before changing the accent — it matches
the brand guide.
Unknown keys are ignored rather than rejected, so a typo costs you that one setting and never the site.