Configuration

All configuration files live in src/config/.

config.json

Controls the site identity, logo, and top-right navigation button.

{
  "site": {
    "title": "Librarian",
    "logo": "/src/assets/logo-shield.svg",
    "logo_darkmode": "/src/assets/logo-shield.svg",
    "logo_width": "32",
    "logo_height": "32",
    "logo_text": "Librarian"
  },
  "settings": {
    "search": true,
    "theme_switcher": true
  },
  "navigation_button": {
    "enable": true,
    "label": "Contribute",
    "link": "/librarian/contribute/getting-started/introduction/overview/"
  }
}

logo / logo_darkmode — paths to logo images in src/assets/. SVG files are served directly; raster formats are optimized via Astro’s image pipeline.

logo_width / logo_height — display dimensions in pixels (no px suffix).

theme_switcher — shows the dark/light mode toggle in the header.

navigation_button — the outlined button on the right side of the header.

sidebar.json

Defines the full content hierarchy. See Navigation for a detailed walkthrough.

menu.en.json

Top nav links and footer link groups.

{
  "main": [
    { "name": "Home", "url": "/" },
    { "name": "Business", "url": "/business/hr/hiring/overview/" }
  ]
}

For dropdown menus, add "hasChildren": true and a "children" array.

theme.json

Brand colors and base font size.

{
  "colors": {
    "default": {
      "theme_color": {
        "primary": "#D76D77"
      }
    }
  },
  "fonts": {
    "font_size": {
      "base": "16",
      "scale": "1.15"
    }
  }
}

social.json

Links shown as icon buttons in the Starlight header area.

{
  "main": [
    { "icon": "github", "label": "GitHub", "href": "https://github.com/..." }
  ]
}

Supported icon names are from the Starlight icon set.