name: default
version: 2.0.0
parent: null

features:
  navigation:
    breadcrumbs: true
    toc: true
    toc.sticky: true
    prev_next: true
    tabs: false
    back_to_top: true
  content:
    code.copy: true
    code.annotate: false
    tabs.link: false
    lightbox: true
    math: false
    reading_time: true
    link_previews: true
    author: true
    excerpts: true
    children: true
  search:
    suggest: true
    highlight: true
    share: false
  footer:
    social: true
  accessibility:
    skip_link: true

# Header layout and behavior configuration
header:
  # Navigation link alignment: "left" (after logo) or "center" (centered in header)
  nav_position: left
  # Whether header stays fixed at top on scroll
  sticky: true
  # Whether header hides on scroll down (only applies when sticky: true)
  autohide: false

appearance:
  default_mode: system
  default_palette: "snow-lynx"

icons:
  library: phosphor
  aliases:
    # Navigation & Actions
    arrow-right: arrow-right
    arrow-left: arrow-left
    arrow-up: arrow-up
    arrow-down: arrow-down
    chevron-right: chevron-right
    chevron-left: chevron-left
    chevron-up: chevron-up
    chevron-down: chevron-down
    external: external
    # Aliases for icons referenced by docs content frontmatter (#288)
    languages: translate
    python: file-py
    robot: sparkle
    stethoscope: heart
    arrows: arrow-clockwise
    link: link
    search: magnifying-glass
    menu: list
    close: x
    # Status & Feedback
    info: info
    warning: warning
    error: x-circle
    check: check
    success: check-circle
    # Files & Content
    file: file
    file-text: file-text
    folder: folder
    document: file
    code: code
    copy: copy
    edit: pencil
    trash: trash
    download: download
    upload: upload
    # UI & Metadata
    settings: settings
    star: star
    heart: heart
    bookmark: bookmark
    tag: tag
    calendar: calendar
    clock: clock
    pin: map-pin
    user: user
    arrow-clockwise: arrow-clockwise
    # Theme
    sun: sun
    moon: moon
    palette: palette
    # Admonitions
    tip: tip
    note: note
    example: example
    danger: danger
    caution: caution
    lightbulb: tip
    # Bengal-specific
    terminal: terminal
    docs: file-text
    notepad: note
    # Mid-century modern (Bengal custom icons)
    atomic: atomic
    starburst: starburst
    boomerang: boomerang
    # Lucide-style aliases (Kida docs, etc.)
    alert-triangle: warning
    alert-circle: warning
    variable: code
    arrows-angle-contract: enlarge
    help-circle: question
    file-plus: file
    refresh-cw: arrow-clockwise
    type: code
    file-x: error
    spell-check: pencil
    plug: puzzle-piece
    activity: timer
    "...": filter
