mkdocs.yaml

# pip3 install mkdocs mkdocs-material
# or
# brew install mkdocs-material
# mkdocs serve

site_name: Trailblaze
repo_name: Trailblaze
repo_url: https://github.com/block/trailblaze
site_description: "AI-powered UI testing framework."
site_author: Block, Inc.
remote_branch: gh-pages

copyright: 'Copyright © 2025 Block, Inc.'

# Build hooks (see docs_hooks.py): fills missing per-trail report-gallery assets with the
# committed generic placeholder so strict builds pass without committing per-trail binaries.
hooks:
  - docs_hooks.py

# The showcase manifest is config for docs_hooks.py + the CI trail scripts, not a page —
# keep it out of the published site. It still lives under docs/ (read from disk by the
# hook) so the gallery's showcase choices sit next to the gallery they drive.
exclude_docs: |
  showcase-trails.yml

theme:
  name: 'material'
  palette:
    - media: '(prefers-color-scheme: light)'
      scheme: default
      primary: 'white'
      accent: 'green'
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
    - media: '(prefers-color-scheme: dark)'
      scheme: slate
      primary: 'black'
      accent: 'green'
      toggle:
        icon: material/brightness-4
        name: Switch to light mode
  font:
    text: 'Inter'
    code: 'Fira Code'
  features:
    - content.code.copy
    - content.code.select
    - navigation.expand

#extra_css:
#  - 'css/app.css'

markdown_extensions:
  - smarty
  - codehilite:
      guess_lang: false
  - footnotes
  - meta
  - toc:
      permalink: true
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.inlinehilite
  - pymdownx.magiclink
  - pymdownx.smartsymbols
  - pymdownx.superfences
  - pymdownx.emoji
  - pymdownx.tabbed:
      alternate_style: true
  - tables
  - admonition
  - attr_list
  - md_in_html