mkdocs.yml

site_name: AI-OS Documentation
site_description: HRM-sMoE LLM training toolkit with a clean GUI, CLI, and installers
site_url: https://wulfic.github.io/AI-OS/
repo_url: https://github.com/Wulfic/AI-OS
repo_name: Wulfic/AI-OS

theme:
  name: material
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: indigo
      accent: indigo
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: indigo
      accent: indigo
      toggle:
        icon: material/brightness-4
        name: Switch to light mode
  features:
    - navigation.instant
    - navigation.tracking
    - navigation.sections
    - navigation.expand
    - navigation.top
    - navigation.indexes
    - search.suggest
    - search.highlight
    - content.code.copy
    - content.tabs.link
  icon:
    repo: fontawesome/brands/github

plugins:
  - search

# Exclude README.md files since MkDocs prefers index.md
exclude_docs: |
  README.md
  guide/README.md
  guide/api/README.md

markdown_extensions:
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true
  - admonition
  - pymdownx.details
  - toc:
      permalink: true
  - tables
  - attr_list
  - md_in_html
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg

extra:
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/Wulfic/AI-OS
    - icon: fontawesome/solid/heart
      link: https://ko-fi.com/S6S31MS4TK

# Navigation is auto-generated from directory structure
# MkDocs will automatically discover all markdown files and create navigation
# Files named index.md become section homepages
# Add .pages files in directories to customize order if needed