Documentation

Themes

Pick a theme, add your branding and navigation, and design your own themes.

On this page 7

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.

  • 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 noindex and robots.txt asks 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 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.