mirror of
https://github.com/blackboxprogramming/BlackRoad-Operating-System.git
synced 2026-03-17 05:57:21 -05:00
180 lines
4.9 KiB
YAML
180 lines
4.9 KiB
YAML
site_name: BlackRoad OS Codex
|
|
site_description: Complete documentation for BlackRoad Operating System
|
|
site_author: BlackRoad OS Team
|
|
site_url: https://blackroad.systems/docs
|
|
site_description: Complete documentation for BlackRoad Operating System - Where AI meets the open road
|
|
site_author: BlackRoad Team
|
|
site_url: https://docs.blackroad.systems
|
|
|
|
repo_name: blackboxprogramming/BlackRoad-Operating-System
|
|
repo_url: https://github.com/blackboxprogramming/BlackRoad-Operating-System
|
|
edit_uri: edit/main/codex-docs/docs/
|
|
|
|
copyright: Copyright © 2025 BlackRoad OS
|
|
|
|
theme:
|
|
name: material
|
|
palette:
|
|
- scheme: slate
|
|
primary: indigo
|
|
accent: purple
|
|
toggle:
|
|
icon: material/brightness-4
|
|
name: Switch to light mode
|
|
- scheme: default
|
|
primary: indigo
|
|
# Light mode
|
|
- media: "(prefers-color-scheme: light)"
|
|
scheme: default
|
|
primary: deep purple
|
|
accent: purple
|
|
toggle:
|
|
icon: material/brightness-7
|
|
name: Switch to dark mode
|
|
# Dark mode
|
|
- media: "(prefers-color-scheme: dark)"
|
|
scheme: slate
|
|
primary: deep purple
|
|
accent: purple
|
|
toggle:
|
|
icon: material/brightness-4
|
|
name: Switch to light mode
|
|
features:
|
|
- navigation.instant
|
|
- navigation.tracking
|
|
- navigation.tabs
|
|
- navigation.tabs.sticky
|
|
- navigation.sections
|
|
- navigation.expand
|
|
- navigation.top
|
|
- search.suggest
|
|
- search.highlight
|
|
- content.code.copy
|
|
|
|
nav:
|
|
- Home: index.md
|
|
- Architecture:
|
|
- Overview: architecture.md
|
|
- 7-Layer Stack: architecture-layers.md
|
|
- Components: components.md
|
|
- Infrastructure:
|
|
- Overview: infra.md
|
|
- Cloudflare Setup: infra-cloudflare.md
|
|
- Railway Deployment: infra-railway.md
|
|
- GitHub Configuration: infra-github.md
|
|
- Modules:
|
|
- Backend API: modules/backend-api.md
|
|
- Core OS Runtime: modules/core-os.md
|
|
- Operator Engine: modules/operator.md
|
|
- Web Client (Pocket OS): modules/web-client.md
|
|
- Prism Console: modules/prism.md
|
|
- Development:
|
|
- Getting Started: dev/getting-started.md
|
|
- Local Setup: dev/local-setup.md
|
|
- Contributing: dev/contributing.md
|
|
- API Reference:
|
|
- System Endpoints: api/system.md
|
|
- Authentication: api/auth.md
|
|
- Agents: api/agents.md
|
|
|
|
markdown_extensions:
|
|
- admonition
|
|
- codehilite
|
|
- pymdownx.highlight
|
|
- pymdownx.superfences
|
|
- pymdownx.tabbed
|
|
- toc:
|
|
permalink: true
|
|
|
|
plugins:
|
|
- search
|
|
- mkdocstrings
|
|
|
|
extra:
|
|
version: 0.1.0
|
|
social:
|
|
- icon: fontawesome/brands/github
|
|
link: https://github.com/blackboxprogramming/BlackRoad-Operating-System
|
|
- content.action.edit
|
|
icon:
|
|
repo: fontawesome/brands/github
|
|
logo: material/road
|
|
|
|
extra:
|
|
social:
|
|
- icon: fontawesome/brands/github
|
|
link: https://github.com/blackboxprogramming/BlackRoad-Operating-System
|
|
- icon: fontawesome/brands/discord
|
|
link: https://discord.gg/blackroad # Discord: Coming in Phase 1 Q2 (community hub)
|
|
version:
|
|
provider: mike
|
|
analytics:
|
|
provider: google
|
|
property: G-XXXXXXXXXX # TODO: Add Google Analytics ID
|
|
|
|
extra_css:
|
|
- stylesheets/extra.css
|
|
|
|
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_index: !!python/name:material.extensions.emoji.twemoji
|
|
emoji_generator: !!python/name:material.extensions.emoji.to_svg
|
|
- pymdownx.highlight:
|
|
anchor_linenums: true
|
|
line_spans: __span
|
|
pygments_lang_class: true
|
|
- pymdownx.inlinehilite
|
|
- pymdownx.keys
|
|
- pymdownx.mark
|
|
- pymdownx.smartsymbols
|
|
- pymdownx.superfences:
|
|
custom_fences:
|
|
- name: mermaid
|
|
class: mermaid
|
|
format: !!python/name:pymdownx.superfences.fence_code_format
|
|
- pymdownx.tabbed:
|
|
alternate_style: true
|
|
- pymdownx.tasklist:
|
|
custom_checkbox: true
|
|
- pymdownx.tilde
|
|
|
|
plugins:
|
|
- search:
|
|
separator: '[\s\-,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
|
|
|
|
nav:
|
|
- Home: index.md
|
|
- Architecture:
|
|
- Overview: architecture/overview.md
|
|
- Phase 2.5 Decisions: architecture/phase2-decisions.md
|
|
- Infrastructure & Deployment: architecture/infra-deployment.md
|
|
- API Reference:
|
|
- Overview: api/overview.md
|
|
- Authentication: api/authentication.md
|
|
- Prism Console: api/prism.md
|
|
- Blockchain: api/blockchain.md
|
|
- Guides:
|
|
- Quick Start: guides/quickstart.md
|
|
- Deployment Guide: guides/deployment.md
|
|
- Development Setup: guides/development.md
|
|
- Environment Variables: guides/environment-variables.md
|
|
- Agents:
|
|
- Overview: agents/overview.md
|
|
- Creating Agents: agents/creating-agents.md
|
|
- Agent Categories: agents/categories.md
|
|
- Contributing: contributing.md
|