Configuration

What belongs in hugo.toml, and why templates stay project-agnostic.

On this page

Every project-specific value lives in hugo.toml. Templates read parameters; they never contain a repository URL, a project name or a colour.

Minimum configuration

toml

baseURL = "https://docs.acme.dev/"
title = "Acme Docs"

[params]
  projectName = "Acme Docs"
  tagline = "Everything about Acme."
  repository = "https://github.com/acme/docs"
  repositoryBranch = "main"
  docsPath = "content"
  defaultTheme = "system"
  accentColor = "#0ea5e9"

See the configuration reference for the full list.

Edit links

"Edit this page" is assembled from three values and the source path of the page being rendered:

text

{repository}/edit/{repositoryBranch}/{docsPath}/{file path}

docsPath is the path from your repository root to the Hugo content directory. For a monorepo where the site lives in apps/docs, set it to apps/docs/content.

Theme colour

The accent colour is injected as a CSS custom property, so light and dark can differ:

toml

[params]
  accentColor = "#6a4cff"
  accentColorDark = "#a690ff"

Everything else — surfaces, borders, text — comes from the token set described in Theming .

Edit this page