mkdocs.yml

site_name: WorldForge
site_description: Testable world-model workflows for physical-AI systems.
site_url: https://abdelstark.github.io/worldforge/
repo_url: https://github.com/AbdelStark/worldforge
repo_name: AbdelStark/worldforge

docs_dir: docs/src
site_dir: site
strict: true
exclude_docs: |
  SUMMARY.md

theme:
  name: material
  language: en
  icon:
    repo: fontawesome/brands/github
  features:
    - content.code.copy
    - navigation.indexes
    - navigation.sections
    - navigation.top
    - search.highlight
    - search.suggest
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: teal
      accent: deep orange
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: teal
      accent: deep orange
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode

nav:
  - Introduction: introduction.md
  - Documentation Map: docs-map.md
  - Getting Started:
      - Quick Start: quickstart.md
      - CLI Reference: cli.md
      - Examples And CLI Commands: examples.md
  - Showcases:
      - Demo Showcase Workflows: demo-showcases.md
      - Use Case Cookbook: use-case-cookbook.md
      - Robotics Replay Showcase: robotics-showcase.md
      - Robotics Showcase Deep Dive: robotics-showcase-deep-dive.md
      - TheWorldHarness: theworldharness.md
      - Rerun Integration: rerun.md
  - System Model:
      - World Model Taxonomy: world-model-taxonomy.md
      - Architecture: architecture.md
  - Decisions:
      - Persistence Adapter Boundary: adr/0001-persistence-adapter-boundary.md
  - Providers:
      - Overview: providers/README.md
      - Cosmos: providers/cosmos.md
      - Cosmos-Policy: providers/cosmos-policy.md
      - Genie: providers/genie.md
      - GR00T: providers/gr00t.md
      - JEPA: providers/jepa.md
      - JEPA-WMS: providers/jepa-wms.md
      - LeWorldModel: providers/leworldmodel.md
      - LeRobot: providers/lerobot.md
      - Runway: providers/runway.md
  - Authoring And API:
      - Provider Authoring Guide: provider-authoring-guide.md
      - External Provider Packages: external-providers.md
      - Scenario Definition Format: scenarios.md
      - Provider Routing And Fallback: provider-routing.md
      - Python API: api/python.md
      - Public API Stability: api-stability.md
      - Capability Fixture Corpus: fixtures.md
      - Capability Negotiation: capability-negotiation.md
  - Evidence And Evaluation:
      - Evaluation: evaluation.md
      - Benchmarking: benchmarking.md
      - Live Smoke Evidence Registry: live-smoke-evidence.md
      - Claim-To-Evidence Map: claim-evidence-map.md
      - Artifact Integrity: artifact-integrity.md
  - Operations And Quality:
      - User And Operator Playbooks: playbooks.md
      - Run Artifact Index: run-index.md
      - Static HTML Reports: html-reports.md
      - World State Diff And Patch: world-diff.md
      - Engineering Quality: quality.md
      - Operations: operations.md
      - Security: security.md
      - Support: support.md
      - Contributing: contributing.md
  - Planning Records:
      - Roadmap: roadmap.md
      - Roadmap Expansion: roadmap-expansion.md
      - Roadmap Continuation: roadmap-continuation.md
      - Provider And Platform Roadmap: provider-platform-roadmap.md
      - Next Provider Selection RFC: provider-selection-rfc.md
      - Provider Cohort Selection Record: provider-cohort-selection.md
      - Spatial Scene Artifact Boundary: spatial-scene-artifact-boundary.md
  - Project Metadata:
      - Changelog: changelog.md
      - Citation: citation.md

markdown_extensions:
  - admonition
  - attr_list
  - md_in_html
  - tables
  - toc:
      permalink: true
  - pymdownx.details
  - pymdownx.highlight:
      anchor_linenums: true
  - pymdownx.superfences
  - pymdownx.tabbed:
      alternate_style: true