mkdocs.yml

# Configuration for the Lemonade Server documentation site.
#
# The site is built with Zensical (the successor to MkDocs Material). Zensical
# reads mkdocs.yml natively, so the filename and most of the Material schema
# carry over from the previous MkDocs Material setup. See zensical.org for
# documentation and upgrades.
#
# To install dependencies:
#   pip install -r docs/assets/docs_requirements.txt
#
# To build (and stage to docs/docs/, the lemonade-server.ai layout):
#   python docs/publish_website_docs.py
#
# To serve locally during authoring:
#   zensical serve

site_name: Lemonade Server Documentation
site_url: https://lemonade-server.ai/
site_description: Lemonade Server is a lightweight, open-source local LLM server that allows you to run and manage multiple AI applications on your local machine. It provides a simple CLI for managing applications and supports various LLMs, making it easy to deploy and use AI models locally.

edit_uri: README.md

repo_name: lemonade-sdk/lemonade
repo_url: https://github.com/lemonade-sdk/lemonade

plugins:
  - search

theme:
  name: material
  custom_dir: docs/overrides
  # Match the homepage's brand mark: small favicon glyph + "Lemonade" wordmark
  # (the wordmark is injected via .md-logo::after in zest-theme.css).
  logo: assets/favicon.ico
  favicon: assets/favicon.ico
  features:
    - navigation.footer
    - navigation.tracking
    - navigation.top
    - content.code.annotate
    - content.code.copy
  # Fonts are loaded by docs/overrides/main.html's `fonts` block (Plus Jakarta
  # Sans + Manrope + Material Symbols), not via theme.font, to avoid double
  # @import requests and keep parity with the homepage's font setup.
  palette:
    - scheme: zest-light
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
    - scheme: zest-dark
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode

# Sidebar / nav structure
nav:
  - Welcome: index.md
  - User Guide:
    - Getting Started: guide/README.md
    - Install:
      - Supported Platforms: guide/install/README.md
      - Ubuntu: guide/install/ubuntu.md
      - Arch: guide/install/arch.md
      - Fedora: guide/install/fedora.md
      - Docker: guide/install/docker.md
    - Local Server Concepts: guide/concepts.md
    - CLI: guide/cli.md
    - Configuration:
      - Service: guide/configuration/README.md
      - Custom Models: guide/configuration/custom-models.md
      - Running Many Models: guide/configuration/multi-model.md
      - llama.cpp: guide/configuration/llamacpp.md
      - vLLM: guide/configuration/vllm.md
    - FAQ: guide/faq.md
  - Development:
    - Overview: dev/README.md
    - Philosophy: dev/philosophy.md
    - Contribute: dev/contribute.md
    - C++: dev/getting-started.md
    - Desktop App: dev/app.md
    - Web UI: dev/web-ui.md
    - Lemonade Omni Models: dev/lemonade-omni.md
    - Infrastructure: dev/self-hosted-runners.md
  - API Spec:
      - Overview: api/README.md
      - OpenAI Compatible: api/openai.md
      - Ollama Compatible: api/ollama.md
      - Anthropic Compatible: api/anthropic.md
      - llama.cpp Specific: api/llamacpp.md
      - Lemonade Specific: api/lemonade.md
  - Embeddable Lemonade:
      - Overview: embeddable/README.md
      - Runtime: embeddable/runtime.md
      - Backends: embeddable/backends.md
      - Models: embeddable/models.md
      - Building from Source: embeddable/building.md

# Footer social links
extra:
  homepage: https://lemonade-server.ai
  social:
    - icon: simple/youtube
      link: https://www.youtube.com/@AMDDevCentral
    - icon: simple/github
      link: https://github.com/lemonade-sdk/lemonade
    - icon: simple/discord
      link: https://discord.gg/5xXzkMu8Zk

copyright: "© 2026 AMD. Licensed under Apache 2.0."

# website-styles.css owns design tokens; zest-theme.css maps them to Zensical.
extra_css:
  - assets/website-styles.css
  - assets/zest-theme.css

# carousel.js handles YouTube embeds inside docs pages.
extra_javascript:
  - assets/carousel.js

markdown_extensions:
  - admonition
  - pymdownx.superfences  # Better code blocks
  - pymdownx.tabbed:      # Tabbed code blocks
      alternate_style: true