Project

Project settings describe the documentation site itself. Keep this page for identity fields that affect metadata, branding, and browser chrome.

{
  "name": "Astro Theme Dahlia",
  "description": "A documentation theme for Astro.",
  "logo": {
    "light": "/images/logo-light.svg",
    "dark": "/images/logo-dark.svg",
    "href": "/"
  },
  "favicon": "/favicon.svg"
}

Routing, i18n, source links, and contributors are separate configuration topics. See Content Routing, Internationalization, and Source.

Name

name is the public product or project name. Dahlia uses it for the site title, header brand text, footer brand text, and schema.org metadata.

"name": "Astro Theme Dahlia"

Page titles are composed from the page frontmatter title and this name.

Description

description is the default site description. Pages can still override it with frontmatter.

"description": "A documentation theme for Astro."

Dahlia uses this value for the default <meta name="description"> and structured data.

Logo

logo is optional. If it is omitted, Dahlia renders the built-in Dahlia mark.

By default, Dahlia treats the logo as a mark and renders it next to name. Use a string when one mark asset works in every theme mode.

"logo": "/images/logo.svg"

Use an object when light and dark mode need different mark assets.

"logo": {
  "light": "/images/logo-light.svg",
  "dark": "/images/logo-dark.svg",
  "href": "/"
}

If your logo asset already includes the project name, set variant: 'lockup'. Dahlia will render the image by itself and skip the extra name text. The default variant is mark.

"logo": {
  "light": "/images/logo-lockup-light.svg",
  "dark": "/images/logo-lockup-dark.svg",
  "variant": "lockup"
}

href controls the brand link target. If omitted, the brand links to /. For local assets in public/, Dahlia reads the image dimensions during the Astro config setup step and renders width and height attributes automatically. Add width and height only for remote logo URLs or custom paths Dahlia cannot read from public/.

Favicon

Use a string for the common single favicon case.

"favicon": "/favicon.svg"

Use an object or array when a project needs multiple favicon links.

"favicon": [
  { "href": "/favicon.svg", "type": "image/svg+xml" },
  { "href": "/favicon.ico", "sizes": "32x32" },
  { "href": "/apple-touch-icon.png", "rel": "apple-touch-icon", "sizes": "180x180" }
]

Each object renders as a <link> in the document head. Supported fields are href, rel, type, sizes, media, and color.