Every site has a theme for its colours, fonts and layout, plus its own branding, header links, footer and banner. Open it from the site's Settings tab with Customize.
The preview on the right shows your real site with your changes. Nothing goes live until you click Save; Discard throws your changes away.
Choose a theme
Six themes are built in:
| Theme | Style |
|---|---|
| Classic | Clean, neutral and easy to read (the default) |
| Midnight | Dark by default, with cool blues |
| Paper | Warm tones and a serif for long reads |
| Terminal | Monospace and square, for command-line tools |
| Spotlight | A bold, brand-coloured header |
| Grape | Warm cream, grape purple and a friendly rounded font |
Your team's own themes are listed below them. Turn on Use a different brand colour on this site to keep a theme but swap its accent colour.
Branding
- Site title: shown in the header. Defaults to the site's name.
- Tagline: a short line, up to 60 characters.
- Logo URL: an SVG or PNG, shown 24px tall.
- Favicon URL: the icon in browser tabs.
Logos and favicons are linked from where you host them; there's no upload.
Search engines and link previews
- Default description: shown in search results and link previews for pages without their own description. Leave it blank to use the tagline.
- Social image URL: the preview image when a page is shared. Leave it blank and each page gets a card made from its title.
- X handle: credited on previews shared on X.
- Let search engines index this site: on by default. Turn it off for
internal or unfinished docs: every page is marked
noindexandrobots.txtasks crawlers to stay away. People with the link can still read the site.
A page's own Description and Social image, set in the editor, always win over these.
Analytics
To see who visits your docs, connect your own Fathom account: turn on Fathom analytics and paste the Fathom site ID from the site's settings in Fathom. Every page then loads Fathom, including pages visitors reach without a full reload.
Previews in the dashboard aren't counted. Maddie Docs doesn't add any analytics or tracking of its own to your site.
Header and footer
- Header navigation: up to six links, each to a web address, a path on your site or an email address, optionally opening in a new tab.
- Search: shows the search bar and the ⌘K shortcut.
- "Edit this page" link: for GitHub sites, Link to GitHub opens the
file in your repository. Or choose Custom link with a template using
{file}or{path}, or Hide. - Footer: turn it on or off, set the text (blank shows a copyright line) and add up to six links.
Announcement banner
Turn on Show a banner to show a strip above the header on every page, with a Message, an optional Link and a Style: Info, Warning or Urgent.
Design your own theme
Click Customize on a built-in theme to start from a copy, or New theme. Team themes can be reused on any of your team's sites, and saving one updates every site using it straight away.
| Area | Options |
|---|---|
| Colours | The accent colour (with its own shade for dark mode), and separate light and dark palettes for background, surface, sidebar, text, muted text, borders and code blocks |
| Default appearance | Match visitor, Light or Dark. Visitors can still switch in the header |
| Corners | Square, Subtle, Rounded or Soft |
| Content width | Narrow, Standard or Wide |
| Header | Plain, Tinted or Brand |
| Typography | Inter, System, Serif, Mono or Rounded for headings and body text. Code always uses a monospace font |
| Custom CSS | Up to 20,000 characters, added after the theme's own styles |
Useful selectors for custom CSS: .laradocs-header, .laradocs-sidebar,
.laradocs-content, .laradocs-toc, .laradocs-footer and
.laradocs-banner.
Deleting a theme switches any site using it back to Classic.