.lychee.toml

# Lychee link checker configuration
# Focused on catching broken local/relative links between docs.
# Install: brew install lychee

#############################  Runtime  #############################

# Only check local files — skip external URLs for speed.
# CI can override with --no-offline for full external checks.
offline = true

# Resolve bare links like [Guide](docs/GUIDE) → docs/GUIDE.md
fallback_extensions = ["md", "html"]

# Check #heading fragment anchors within markdown files
include_fragments = true

# No interactive progress bar (clean output in hooks/CI)
no_progress = true

#############################  Exclusions  ##########################

# Paths to skip entirely
exclude_path = [
  "node_modules",
  "examples",
  "ROADMAP.md",
  "CHANGELOG.md",
]

# URL patterns to ignore (even in offline mode, lychee parses these)
exclude = [
  "^https?://",
  "^mailto:",
]

# Only check markdown files
extensions = ["md"]