mkdocs.yml

# Source: https://github.com/squidfunk/mkdocs-material/blob/master/mkdocs.yml

# Project information
site_name: DeepCube Docs
site_url: https://docs.deepcube.ai
site_description: DeepCube™. The spatial observability platform.
site_author: Immersive Fusion LLC

# Repository
repo_name: deepcube-docs
repo_url: https://github.com/ImmersiveFusion/deepcube-docs
edit_uri: edit/main/docs

# Copyright
copyright: Copyright &copy; 2020-2026 <a href="https://www.immersivefusion.com">Immersive Fusion LLC</a>, Maintained by the <a href="/contact/">Immersive Team</a>. Portions of this documentation are AI-assisted

watch:
  - docs
  - overrides

# Configuration
theme:
  name: material
  custom_dir: overrides
  features:
    - announce.dismiss
    - content.action.edit
    - content.action.view
    - content.code.annotate
    - content.code.copy
    - content.code.select
    - content.tabs.link
    - content.tooltips
    # - header.autohide
    # - navigation.expand
    - navigation.footer
    - navigation.indexes
    #- navigation.instant
    #- navigation.instant.prefetch
    #- navigation.instant.progress
    #- navigation.prune
    - navigation.sections
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.top
    - navigation.tracking
    - search.highlight
    # - search.share  # Disabled to prevent Google indexing ?q= URLs
    - search.suggest
    - toc.follow
    # - toc.integrate
  palette:
    # Dark mode first (default); colours come from the dc-styles tokens via css/extra.css
    - scheme: slate
      primary: custom
      accent: custom
      toggle:
        icon: material/brightness-4
        name: Switch to light mode
    # Light mode alternative
    - scheme: default
      primary: custom
      accent: custom
      toggle:
        icon: material/brightness-7
        name: Switch to dark mode
  # Fonts are self-hosted from the DeepCube design kit (css/fonts.css); false stops Material loading Google Fonts.
  font: false
  # Shared brand icon family (sibling of immersivefusion.academy). The full
  # family (apple-touch-icon, web-app-manifest PNGs, site.webmanifest,
  # theme-color) is wired in overrides/main.html {% block extrahead %}.
  favicon: favicon.ico
  # icon:
  #   logo: assets/logo
  logo: favicon-96x96.png

# Plugins
hooks:
  # Derives a page's meta description from its own opening paragraph when
  # the page does not declare one. Explicit front matter always wins.
  - hooks/meta_descriptions.py

plugins:
  #- blog
  - search:
      separator: '[\s\u200b\-_,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
  - tags
  - awesome-pages
        #collapse_single_pages: false
  - section-index
  - glightbox:
      touchNavigation: true
      loop: false
      effect: zoom
      slide_effect: slide
      width: 100%
      height: auto
      zoomable: true
      draggable: true
  - git-revision-date-localized:
      enable_creation_date: true
      type: timeago
  - minify:
      minify_html: true
  - redirects:
      redirect_maps:
        # 'instrument/index.md' redirect removed - now a real page at Instrument/index.md
        # On case-insensitive filesystems (Windows/Azure), this causes zip duplicate conflicts

        # --- Retired URLs (bus #2052, Trout) ---------------------------------
        # Twelve live URLs Google still serves returned 404, carrying 20.9% of
        # docs impressions and 33.3% of docs clicks. These pages were removed or
        # relocated and the redirect leg was never shipped.
        #
        # Where a successor exists it is used. Where none exists the page is
        # RETIRED DELIBERATELY to the nearest live surface (founder, 2026-08-27)
        # rather than guessed at: a 301 onto a plausible-but-wrong page launders
        # a dead link into a live wrong answer, which is worse than the 404.
        # Every target below was probed and returns 200.

        # Direct successor.
        'Resources/Terms-and-Concepts/IAPM/index.md': 'Resources/Terms-and-Concepts/DC/index.md'

        # Partner: Affiliates has a direct successor on the storefront. The
        # storefront has no partner index (both casings 404), and Benefactors has
        # no counterpart anywhere, so those retire to the Resources index.
        # Spatial-Observatory retires to the property that now carries that
        # subject, and Hall-of-Supporters goes to the SAME place rather than
        # hopping through Spatial-Observatory: src/redirects.conf has chained it
        # there since 2026, and following that chain now would make it two hops.
        'Resources/Partner/Affiliates/index.md': 'https://immersivefusion.com/partner/Affiliate'
        'Resources/Partner/Spatial-Observatory/index.md': 'https://spatialobservability.org/'
        'Resources/Partner/index.md': 'Resources/index.md'
        'Resources/Partner/Benefactors/index.md': 'Resources/index.md'
        'Resources/Partner/Hall-of-Supporters/index.md': 'https://spatialobservability.org/'

        # Commercial offers and the ROI calculator: no docs successor and no
        # like-for-like page on the storefront. Retired to pricing, which is the
        # live surface that now answers what these asked.
        'Resources/Toolkit/index.md': 'https://immersivefusion.com/pricing/'
        'Resources/Toolkit/calculator.md': 'https://immersivefusion.com/pricing/'
        'Setup/Offers/azure-marketplace.md': 'https://immersivefusion.com/pricing/'
        'Setup/Discounts/early-adopter.md': 'https://immersivefusion.com/pricing/'

        # Service Level Agreement: commercial commitments (uptime targets,
        # service credits, support response times) do not belong in a repo that
        # accepts outside pull requests, and the page named tiers
        # (Starter/Professional/Enterprise) that Getting-Started/Plans does not
        # use. Retired to the legal index, which carries the Subscription
        # Agreement -- the instrument that actually binds.
        'Resources/Legal/sla.md': 'https://immersivefusion.com/legal/'

        # Data Residency was a stub carrying only its own heading, published and
        # returning 200. The parent Data-Security page already has a Data
        # Residency section with the region table, so the child was redundant
        # rather than merely unfinished. Retired to the page that answers it.
        'Resources/Legal/Data-Security/Data-Residency/index.md': 'Resources/Legal/Data-Security/index.md'

        # Steam notes renamed to dotless. serve resolves a path segment
        # containing dots as a filename, so /steam/1.9.0/ never reached its
        # index.html and served a directory listing instead -- on all eleven,
        # all of which are in the sitemap. Verified against the real server:
        # the dotless form serves the page, the dotted form lists the folder.
        'DC/3D/steam/1.9.0.md': 'DC/3D/steam/1-9-0.md'
        'DC/3D/steam/1.10.0.md': 'DC/3D/steam/1-10-0.md'
        'DC/3D/steam/1.11.0.md': 'DC/3D/steam/1-11-0.md'
        'DC/3D/steam/1.12.0.md': 'DC/3D/steam/1-12-0.md'
        'DC/3D/steam/1.12.1.md': 'DC/3D/steam/1-12-1.md'
        'DC/3D/steam/1.14.0.md': 'DC/3D/steam/1-14-0.md'
        'DC/3D/steam/1.14.11.md': 'DC/3D/steam/1-14-11.md'
        'DC/3D/steam/1.15.0.md': 'DC/3D/steam/1-15-0.md'
        'DC/3D/steam/1.17.0.md': 'DC/3D/steam/1-17-0.md'
        'DC/3D/steam/1.18.0.md': 'DC/3D/steam/1-18-0.md'
        'DC/3D/steam/1.18.8.md': 'DC/3D/steam/1-18-8.md'

        # Restructure redirects - preserve old URLs
        # Analysis-and-Visualization → DC/3D / DC/Web
        'analysis-and-visualization/index.md': 'DC/3D/index.md'
        'analysis-and-visualization/3d-and-vr/index.md': 'DC/3D/index.md'
        'analysis-and-visualization/3d-and-vr/guides/index.md': 'DC/3D/Guides/index.md'
        'analysis-and-visualization/3d-and-vr/guides/installation/index.md': 'DC/3D/Guides/Installation/index.md'
        'analysis-and-visualization/3d-and-vr/guides/installation/windows/index.md': 'DC/3D/Guides/Installation/Windows/index.md'
        'analysis-and-visualization/3d-and-vr/guides/installation/mac/index.md': 'DC/3D/Guides/Installation/macOS/index.md'
        'analysis-and-visualization/3d-and-vr/guides/installation/linux/index.md': 'DC/3D/Guides/Installation/Linux/index.md'
        'analysis-and-visualization/3d-and-vr/guides/navigation/index.md': 'DC/3D/Guides/Navigation/index.md'
        'analysis-and-visualization/3d-and-vr/guides/preferences/index.md': 'DC/3D/Guides/Preferences/index.md'
        'analysis-and-visualization/3d-and-vr/guides/uninstallation/index.md': 'DC/3D/Guides/Uninstallation/index.md'
        'analysis-and-visualization/3d-and-vr/guides/uninstallation/windows/index.md': 'DC/3D/Guides/Uninstallation/Windows/index.md'
        'analysis-and-visualization/3d-and-vr/guides/uninstallation/mac/index.md': 'DC/3D/Guides/Uninstallation/macOS/index.md'
        'analysis-and-visualization/3d-and-vr/guides/uninstallation/linux/index.md': 'DC/3D/Guides/Uninstallation/Linux/index.md'
        'analysis-and-visualization/3d-and-vr/integrations/index.md': 'DC/3D/Integrations/index.md'
        'analysis-and-visualization/3d-and-vr/integrations/htc-vive/index.md': 'DC/3D/Integrations/HTC-Vive/index.md'
        'analysis-and-visualization/3d-and-vr/integrations/meta-quest/index.md': 'DC/3D/Integrations/Meta-Quest/index.md'
        'analysis-and-visualization/3d-and-vr/supported-configurations/index.md': 'DC/3D/Supported-Configurations/index.md'
        'analysis-and-visualization/3d-and-vr/release-notes.md': 'DC/3D/release-notes.md'

        'analysis-and-visualization/web-and-mobile/index.md': 'DC/Web/index.md'
        'analysis-and-visualization/web-and-mobile/guides/index.md': 'DC/Web/Guides/index.md'
        'analysis-and-visualization/web-and-mobile/supported-configurations/index.md': 'DC/Web/Supported-Configurations/index.md'
        'analysis-and-visualization/web-and-mobile/release-notes.md': 'DC/Web/release-notes.md'

        # Mac → macOS redirects
        'Products/IAPM-Desktop/Guides/Installation/Mac/index.md': 'DC/3D/Guides/Installation/macOS/index.md'
        'Products/IAPM-Desktop/Guides/Uninstallation/Mac/index.md': 'DC/3D/Guides/Uninstallation/macOS/index.md'

        # Old IAPM paths removed - 'iapm/' collides with real 'IAPM/' on case-insensitive filesystems
        # 'iapm/index.md', 'iapm/features/index.md', 'iapm/guides/index.md' dropped
        'iapm-web/index.md': 'DC/Web/index.md'

        # IAPM/ → DC/ rebrand redirects (folders moved; preserve all live URLs)
        # CRITICAL: never add lowercase 'dc/...' redirects -- they collide with real DC/ on Windows/Azure
        'IAPM/index.md': 'DC/index.md'
        'IAPM/3D/index.md': 'DC/3D/index.md'
        'IAPM/3D/release-notes.md': 'DC/3D/release-notes.md'
        'IAPM/3D/Features/index.md': 'DC/3D/Features/index.md'
        'IAPM/3D/Features/360-view.md': 'DC/3D/Features/360-view.md'
        'IAPM/3D/Features/ai-assistant.md': 'DC/3D/Overview/ai-assistant.md'
        'IAPM/3D/Features/immersion.md': 'DC/3D/Features/immersion.md'
        'IAPM/3D/Features/real-time.md': 'DC/3D/Features/real-time.md'
        'IAPM/3D/Features/Tessa/diagnostics.md': 'DC/3D/Reference/assistant-diagnostics.md'
        'IAPM/3D/Features/Tessa/prompts.md': 'DC/3D/How-to/assistant-prompts.md'
        'IAPM/3D/Features/Tessa/skills.md': 'DC/3D/Reference/assistant-skills.md'
        'IAPM/3D/Features/Tessa/vision.md': 'DC/3D/How-to/assistant-vision.md'
        'IAPM/3D/Features/Tessa/voice.md': 'DC/3D/How-to/assistant-voice.md'
        'IAPM/3D/Guides/index.md': 'DC/3D/Guides/index.md'
        'IAPM/3D/Guides/Installation/index.md': 'DC/3D/Guides/Installation/index.md'
        'IAPM/3D/Guides/Installation/Windows/index.md': 'DC/3D/Guides/Installation/Windows/index.md'
        'IAPM/3D/Guides/Installation/macOS/index.md': 'DC/3D/Guides/Installation/macOS/index.md'
        'IAPM/3D/Guides/Installation/Linux/index.md': 'DC/3D/Guides/Installation/Linux/index.md'
        'IAPM/3D/Guides/Navigation/index.md': 'DC/3D/Guides/Navigation/index.md'
        'IAPM/3D/Guides/Preferences/index.md': 'DC/3D/Guides/Preferences/index.md'
        'IAPM/3D/Guides/Scenarios/index.md': 'DC/3D/Tutorials/index.md'
        'IAPM/3D/Guides/Scenarios/first-session.md': 'DC/3D/Tutorials/first-session.md'
        'IAPM/3D/Guides/Scenarios/latency-spike.md': 'DC/3D/Tutorials/latency-spike.md'
        'IAPM/3D/Guides/Scenarios/root-cause-analysis.md': 'DC/3D/Tutorials/root-cause-analysis.md'
        'IAPM/3D/Guides/Scenarios/service-graph.md': 'DC/3D/Tutorials/service-graph.md'
        'IAPM/3D/Guides/Uninstallation/index.md': 'DC/3D/Guides/Uninstallation/index.md'
        'IAPM/3D/Guides/Uninstallation/Windows/index.md': 'DC/3D/Guides/Uninstallation/Windows/index.md'
        'IAPM/3D/Guides/Uninstallation/macOS/index.md': 'DC/3D/Guides/Uninstallation/macOS/index.md'
        'IAPM/3D/Guides/Uninstallation/Linux/index.md': 'DC/3D/Guides/Uninstallation/Linux/index.md'
        'IAPM/3D/Integrations/index.md': 'DC/3D/Integrations/index.md'
        'IAPM/3D/Integrations/HTC-Vive/index.md': 'DC/3D/Integrations/HTC-Vive/index.md'
        'IAPM/3D/Integrations/Meta-Quest/index.md': 'DC/3D/Integrations/Meta-Quest/index.md'
        'IAPM/3D/Supported-Configurations/index.md': 'DC/3D/Supported-Configurations/index.md'
        'IAPM/3D/Troubleshooting/index.md': 'DC/3D/Troubleshooting/index.md'
        'IAPM/3D/steam/1.9.0.md': 'DC/3D/steam/1-9-0.md'
        'IAPM/3D/steam/1.10.0.md': 'DC/3D/steam/1-10-0.md'
        'IAPM/3D/steam/1.11.0.md': 'DC/3D/steam/1-11-0.md'
        'IAPM/3D/steam/1.12.0.md': 'DC/3D/steam/1-12-0.md'
        'IAPM/3D/steam/1.12.1.md': 'DC/3D/steam/1-12-1.md'
        'IAPM/3D/steam/1.14.0.md': 'DC/3D/steam/1-14-0.md'
        'IAPM/3D/steam/1.14.11.md': 'DC/3D/steam/1-14-11.md'
        'IAPM/3D/steam/1.15.0.md': 'DC/3D/steam/1-15-0.md'
        'IAPM/Web/index.md': 'DC/Web/index.md'
        'IAPM/Web/release-notes.md': 'DC/Web/release-notes.md'
        'IAPM/Web/Features/index.md': 'DC/Web/Features/index.md'
        'IAPM/Web/Guides/index.md': 'DC/Web/Guides/index.md'
        'IAPM/Web/Supported-Configurations/index.md': 'DC/Web/Supported-Configurations/index.md'
        'IAPM/Web/Troubleshooting/index.md': 'DC/Web/Troubleshooting/index.md'
        'IAPM/Studio/index.md': 'DC/Studio/index.md'
        'IAPM/Studio/release-notes.md': 'DC/Studio/release-notes.md'
        'IAPM/Studio/Features/index.md': 'DC/Studio/Features/index.md'
        'IAPM/Studio/Guides/index.md': 'DC/Studio/Guides/index.md'
        'IAPM/Studio/Guides/Installation/index.md': 'DC/Studio/Guides/Installation/index.md'
        'IAPM/Studio/Supported-Configurations/index.md': 'DC/Studio/Supported-Configurations/index.md'
        'IAPM/Studio/Troubleshooting/index.md': 'DC/Studio/Troubleshooting/index.md'

        # Products/IAPM → DC/3D redirects (old intermediate structure)
        'Products/IAPM/index.md': 'DC/3D/index.md'
        'Products/IAPM/Features/index.md': 'DC/3D/Features/index.md'
        'Products/IAPM/Guides/index.md': 'DC/3D/Guides/index.md'
        'Products/IAPM/Guides/Installation/index.md': 'DC/3D/Guides/Installation/index.md'
        'Products/IAPM/Guides/Installation/Windows/index.md': 'DC/3D/Guides/Installation/Windows/index.md'
        'Products/IAPM/Guides/Installation/macOS/index.md': 'DC/3D/Guides/Installation/macOS/index.md'
        'Products/IAPM/Guides/Installation/Linux/index.md': 'DC/3D/Guides/Installation/Linux/index.md'
        'Products/IAPM/Guides/Navigation/index.md': 'DC/3D/Guides/Navigation/index.md'
        'Products/IAPM/Guides/Preferences/index.md': 'DC/3D/Guides/Preferences/index.md'
        'Products/IAPM/Guides/Uninstallation/index.md': 'DC/3D/Guides/Uninstallation/index.md'
        'Products/IAPM/Guides/Uninstallation/Windows/index.md': 'DC/3D/Guides/Uninstallation/Windows/index.md'
        'Products/IAPM/Guides/Uninstallation/macOS/index.md': 'DC/3D/Guides/Uninstallation/macOS/index.md'
        'Products/IAPM/Guides/Uninstallation/Linux/index.md': 'DC/3D/Guides/Uninstallation/Linux/index.md'
        'Products/IAPM/Integrations/index.md': 'DC/3D/Integrations/index.md'
        'Products/IAPM/Integrations/HTC-Vive/index.md': 'DC/3D/Integrations/HTC-Vive/index.md'
        'Products/IAPM/Integrations/Meta-Quest/index.md': 'DC/3D/Integrations/Meta-Quest/index.md'
        'Products/IAPM/Supported-Configurations/index.md': 'DC/3D/Supported-Configurations/index.md'
        'Products/IAPM/release-notes.md': 'DC/3D/release-notes.md'
        'Products/IAPM/Features/AI-Copilot.md': 'DC/3D/Overview/ai-assistant.md'
        'Products/IAPM-Desktop/Features/AI-Copilot.md': 'DC/3D/Overview/ai-assistant.md'

        # Products/IAPM-Desktop → DC/3D redirects
        'Products/index.md': 'DC/index.md'
        'Products/IAPM-Desktop/index.md': 'DC/3D/index.md'
        'Products/IAPM-Desktop/Features/index.md': 'DC/3D/Features/index.md'
        'Products/IAPM-Desktop/Features/ai-assistant.md': 'DC/3D/Overview/ai-assistant.md'
        'Products/IAPM-Desktop/Features/AI-Assistant.md': 'DC/3D/Overview/ai-assistant.md'
        'Products/IAPM-Desktop/Features/real-time.md': 'DC/3D/Features/real-time.md'
        'Products/IAPM-Desktop/Features/immersion.md': 'DC/3D/Features/immersion.md'
        'Products/IAPM-Desktop/Features/360-view.md': 'DC/3D/Features/360-view.md'
        'Products/IAPM-Desktop/Guides/index.md': 'DC/3D/Guides/index.md'
        'Products/IAPM-Desktop/Guides/Installation/index.md': 'DC/3D/Guides/Installation/index.md'
        'Products/IAPM-Desktop/Guides/Installation/Windows/index.md': 'DC/3D/Guides/Installation/Windows/index.md'
        'Products/IAPM-Desktop/Guides/Installation/macOS/index.md': 'DC/3D/Guides/Installation/macOS/index.md'
        'Products/IAPM-Desktop/Guides/Installation/Linux/index.md': 'DC/3D/Guides/Installation/Linux/index.md'
        'Products/IAPM-Desktop/Guides/Navigation/index.md': 'DC/3D/Guides/Navigation/index.md'
        'Products/IAPM-Desktop/Guides/Preferences/index.md': 'DC/3D/Guides/Preferences/index.md'
        'Products/IAPM-Desktop/Guides/Uninstallation/index.md': 'DC/3D/Guides/Uninstallation/index.md'
        'Products/IAPM-Desktop/Guides/Uninstallation/Windows/index.md': 'DC/3D/Guides/Uninstallation/Windows/index.md'
        'Products/IAPM-Desktop/Guides/Uninstallation/macOS/index.md': 'DC/3D/Guides/Uninstallation/macOS/index.md'
        'Products/IAPM-Desktop/Guides/Uninstallation/Linux/index.md': 'DC/3D/Guides/Uninstallation/Linux/index.md'
        'Products/IAPM-Desktop/Integrations/index.md': 'DC/3D/Integrations/index.md'
        'Products/IAPM-Desktop/Integrations/HTC-Vive/index.md': 'DC/3D/Integrations/HTC-Vive/index.md'
        'Products/IAPM-Desktop/Integrations/Meta-Quest/index.md': 'DC/3D/Integrations/Meta-Quest/index.md'
        'Products/IAPM-Desktop/Supported-Configurations/index.md': 'DC/3D/Supported-Configurations/index.md'
        'Products/IAPM-Desktop/release-notes.md': 'DC/3D/release-notes.md'

        # Products/IAPM-Web → DC/Web redirects
        'Products/IAPM-Web/index.md': 'DC/Web/index.md'
        'Products/IAPM-Web/Guides/index.md': 'DC/Web/Guides/index.md'
        'Products/IAPM-Web/Supported-Configurations/index.md': 'DC/Web/Supported-Configurations/index.md'
        'Products/IAPM-Web/release-notes.md': 'DC/Web/release-notes.md'

        # Configuration-and-Management → Setup
        'configuration-and-management/index.md': 'Getting-Started/index.md'
        'configuration-and-management/sandbox/index.md': 'Getting-Started/Sandbox/index.md'
        'configuration-and-management/login/index.md': 'Getting-Started/Login/index.md'
        'configuration-and-management/account/index.md': 'Getting-Started/Account/index.md'
        'configuration-and-management/api-key/index.md': 'Getting-Started/Api-Key/index.md'
        'configuration-and-management/custom-application/index.md': 'Getting-Started/Custom-application/index.md'

        # Setup/Custom-application/Instrument → Instrument (promoted to top-level)
        # Old page replaced with redirect notice pointing to new Instrument/ section
        # Per-language sub-paths redirect safely (no real files at old paths)
        'Setup/Custom-application/Instrument-your-application/index.md': 'Instrument/index.md'
        'Setup/Custom-application/Instrument-your-application/dotnet/index.md': 'Instrument/dotnet/index.md'
        'Setup/Custom-application/Instrument-your-application/java/index.md': 'Instrument/java/index.md'
        'Setup/Custom-application/Instrument-your-application/python/index.md': 'Instrument/python/index.md'
        'Setup/Custom-application/Instrument-your-application/nodejs/index.md': 'Instrument/nodejs/index.md'
        'Setup/Custom-application/Instrument-your-application/go/index.md': 'Instrument/go/index.md'

        # Short marketing-friendly aliases
        'ai/index.md': 'DC/3D/Overview/ai-assistant.md'
        'copilot/index.md': 'DC/3D/Overview/ai-assistant.md'
        'ai-assistant/index.md': 'DC/3D/Overview/ai-assistant.md'
        'config/index.md': 'Getting-Started/index.md'
        # 'api/index.md' redirect removed - now a real page at API/index.md (case-insensitive collision)
        'sdk/index.md': 'Instrument/index.md'

        #social
        'social/x/index.md': 'https://x.com/immersivefusion'
        'social/linkedin/index.md': 'https://www.linkedin.com/company/immersivefusion'
        'social/mastodon/index.md': 'https://mastodon.social/@immersivefusion'
        'social/youtube/index.md': 'https://www.youtube.com/@immersivefusion'
        'social/facebook/index.md': 'https://www.facebook.com/immersivefusion'
        'social/github/index.md': 'https://github.com/immersivefusion'
        'social/instagram/index.md': 'https://www.instagram.com/immersivefusion'
        
        #links
        'link/discord/index.md': 'https://discord.gg/zevywnQp6K'

        # SP-071 D1: Scenarios -> Tutorials (2026-05-20)
        'DC/3D/Guides/Scenarios/index.md': 'DC/3D/Tutorials/index.md'
        'DC/3D/Guides/Scenarios/first-session.md': 'DC/3D/Tutorials/first-session.md'
        'DC/3D/Guides/Scenarios/latency-spike.md': 'DC/3D/Tutorials/latency-spike.md'
        'DC/3D/Guides/Scenarios/root-cause-analysis.md': 'DC/3D/Tutorials/root-cause-analysis.md'
        'DC/3D/Guides/Scenarios/service-graph.md': 'DC/3D/Tutorials/service-graph.md'

        # SP-071 D2: Tessa split (Features/Tessa/* -> Reference/, Features/ai-assistant.md -> Overview/, voice/vision/prompts -> How-to/) (2026-05-23)
        # ai/, copilot/, ai-assistant/ marketing aliases retargeted in place above (lines 272-274)
        # IAPM/3D/Features/Tessa/* legacy keys retargeted in place above (lines 146, 149-153)
        'DC/3D/Features/ai-assistant.md': 'DC/3D/Overview/ai-assistant.md'
        'DC/3D/Features/Tessa/diagnostics.md': 'DC/3D/Reference/assistant-diagnostics.md'
        'DC/3D/Features/Tessa/skills.md': 'DC/3D/Reference/assistant-skills.md'
        'DC/3D/Features/Tessa/voice.md': 'DC/3D/How-to/assistant-voice.md'
        'DC/3D/Features/Tessa/vision.md': 'DC/3D/How-to/assistant-vision.md'
        'DC/3D/Features/Tessa/prompts.md': 'DC/3D/How-to/assistant-prompts.md'
        # PBI 2801 (SP-2801) nav restructure (2026-07-31): Setup->Getting-Started, API+Integrations->Resources, What's New->top-level, 3D glossary->spatial-vocabulary
        'API/index.md': 'Resources/API/index.md'
        'API/authentication.md': 'Resources/API/authentication.md'
        'API/traces.md': 'Resources/API/traces.md'
        'API/logs.md': 'Resources/API/logs.md'
        'API/diagnostics.md': 'Resources/API/diagnostics.md'
        'API/charts.md': 'Resources/API/charts.md'
        'API/assistant.md': 'Resources/API/assistant.md'
        'Integrations/MCP/index.md': 'Resources/Integrations/MCP/index.md'
        'Resources/whats-new.md': 'whats-new.md'
        'Setup/index.md': 'Getting-Started/index.md'
        'Setup/Account/index.md': 'Getting-Started/Account/index.md'
        'Setup/Api-Key/index.md': 'Getting-Started/Api-Key/index.md'
        'Setup/Best-Practices/index.md': 'Getting-Started/Best-Practices/index.md'
        'Setup/Custom-application/index.md': 'Getting-Started/Custom-application/index.md'
        'Setup/Login/index.md': 'Getting-Started/Login/index.md'
        'Setup/Plans/index.md': 'Getting-Started/Plans/index.md'
        'Setup/Sandbox/index.md': 'Getting-Started/Sandbox/index.md'
        'Setup/Sandbox/guided-tour.md': 'Getting-Started/Sandbox/guided-tour.md'
        'DC/3D/Reference/glossary.md': 'DC/3D/Reference/spatial-vocabulary.md'

# Hooks
# hooks:
#   - material/overrides/hooks/shortcodes.py
#   - material/overrides/hooks/translations.py

# Additional configuration
extra:
  homepage: /
  annotate:
    json: [.s2]
  # No client-side analytics: Google Analytics was removed (bus #5884, founder
  # 2026-11-09: no consent prompt). Visitor metrics come server-side instead (#7453).

  social:
    #  - icon: fontawesome/solid/home
    #    link: https://www.immersivefusion.com
    #  - icon: fontawesome/solid/server
    #    link: https://my.immersivefusion.com
    #  - icon: fontawesome/brands/instagram
    #    link: https://www.instagram.com/immersivefusion
    #  - icon: fontawesome/brands/youtube
    #    link: https://www.youtube.com/channel/UCVf6dSkjq0YaqgNAIRGjvwg
    #  - icon: fontawesome/brands/x
    #    link: https://x.com/immersivefusion      
    #  - icon: fontawesome/brands/facebook
    #    link: https://www.facebook.com/immersivefusion
    #  - icon: fontawesome/brands/linkedin
    #    link: https://www.linkedin.com/company/immersivefusion
    #  - icon: fontawesome/brands/github
    #    link: https://github.com/immersivefusion

# Extensions
markdown_extensions:
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - toc:
      permalink: true
  - pymdownx.arithmatex:
      generic: true
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.details
  - pymdownx.emoji:
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
      emoji_index: !!python/name:material.extensions.emoji.twemoji
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.magiclink:
      normalize_issue_symbols: true
      repo_url_shorthand: true
      user: squidfunk
      repo: mkdocs-material
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.snippets:
      auto_append:
        - includes/mkdocs.md
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
      combine_header_slug: true
      slugify: !!python/object/apply:pymdownx.slugs.slugify
        kwds:
          case: lower
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tilde
  - markdown_include.include:
      base_path: docs

extra_javascript: []
  #- https://static.zdassets.com/ekr/snippet.js?key=b33c5a1c-bfe2-432b-84ae-613f7eb1d2b6
  # Removed: require.js 2.3.6 (CVE-2024-38999, CVSS 10.0) and highlight.js 10.1.1 (2 CVEs)
  # Both were vestigial - pymdownx.highlight handles syntax highlighting server-side via Pygments
extra_css:
  # DeepCube design kit (dc-styles): fonts, then the vendored tokens, then the site's bridge and rules.
  - css/fonts.css
  - css/vendor/dc-tokens.css
  - css/extra.css
# # Page tree
# nav:
#   - Home: index.md
#   - Getting started:
#     - Installation: getting-started.md
#     - Creating your site: creating-your-site.md
#     - Publishing your site: publishing-your-site.md
#     - Customization: customization.md
#     - Conventions: conventions.md
#     - Browser support: browser-support.md
#     - Enterprise feedback: enterprise-support.md
#     - Philosophy: philosophy.md
#     - Alternatives: alternatives.md
#     - License: license.md
#     - Changelog:
#       - changelog/index.md
#       - How to upgrade: upgrade.md
#     - Contributing:
#       - contributing/index.md
#       - Reporting a bug: contributing/reporting-a-bug.md
#       - Reporting a docs issue: contributing/reporting-a-docs-issue.md
#       - Requesting a change: contributing/requesting-a-change.md
#       - Adding translations: contributing/adding-translations.md
#       - Asking a question: https://github.com/squidfunk/mkdocs-material/discussions
#     - Guides:
#       - Creating a reproduction: guides/creating-a-reproduction.md
#   - Setup:
#     - setup/index.md
#     - Changing the colors: setup/changing-the-colors.md
#     - Changing the fonts: setup/changing-the-fonts.md
#     - Changing the language: setup/changing-the-language.md
#     - Changing the logo and icons: setup/changing-the-logo-and-icons.md
#     - Ensuring data privacy: setup/ensuring-data-privacy.md
#     - Setting up navigation: setup/setting-up-navigation.md
#     - Setting up site search: setup/setting-up-site-search.md
#     - Setting up site analytics: setup/setting-up-site-analytics.md
#     - Setting up social cards: setup/setting-up-social-cards.md
#     - Setting up a blog: setup/setting-up-a-blog.md
#     - Setting up tags: setup/setting-up-tags.md
#     - Setting up versioning: setup/setting-up-versioning.md
#     - Setting up the header: setup/setting-up-the-header.md
#     - Setting up the footer: setup/setting-up-the-footer.md
#     - Adding a git repository: setup/adding-a-git-repository.md
#     - Adding a comment system: setup/adding-a-comment-system.md
#     - Building an optimized site: setup/building-an-optimized-site.md
#     - Building for offline usage: setup/building-for-offline-usage.md
#     - Extensions:
#       - setup/extensions/index.md
#       - Python Markdown: setup/extensions/python-markdown.md
#       - Python Markdown Extensions: setup/extensions/python-markdown-extensions.md
#   - Plugins:
#     - plugins/index.md
#     - Blog: plugins/blog.md
#     - Group: plugins/group.md
#     - Info: plugins/info.md
#     - Meta: plugins/meta.md
#     - Offline: plugins/offline.md
#     - Optimize: plugins/optimize.md
#     - Privacy: plugins/privacy.md
#     - Projects: plugins/projects.md
#     - Search: plugins/search.md
#     - Social: plugins/social.md
#     - Tags: plugins/tags.md
#     - Typeset: plugins/typeset.md
#     - Requirements:
#       - Image processing: plugins/requirements/image-processing.md
#       - Caching: plugins/requirements/caching.md
#   - Reference:
#     - reference/index.md
#     - Admonitions: reference/admonitions.md
#     - Annotations: reference/annotations.md
#     - Buttons: reference/buttons.md
#     - Code blocks: reference/code-blocks.md
#     - Content tabs: reference/content-tabs.md
#     - Data tables: reference/data-tables.md
#     - Diagrams: reference/diagrams.md
#     - Footnotes: reference/footnotes.md
#     - Formatting: reference/formatting.md
#     - Grids: reference/grids.md
#     - Icons, Emojis: reference/icons-emojis.md
#     - Images: reference/images.md
#     - Lists: reference/lists.md
#     - Math: reference/math.md
#     - Tooltips: reference/tooltips.md
#   - Insiders:
#     - insiders/index.md
#     - Getting started: insiders/getting-started.md
#     - FAQ: insiders/faq/sponsoring.md
#     - Changelog:
#       - insiders/changelog/index.md
#       - How to upgrade: insiders/upgrade.md
#     - Community Experts Program:
#       - insiders/community-experts-program/index.md
#   - Blog:
#     - blog/index.md