{
  "id": "home",
  "title": "Aurelius",
  "description": "A static documentation generator that delivers a polished reading experience and predictable contracts for agents.",
  "type": "overview",
  "status": "observed",
  "visibility": "public",
  "tags": [
    "documentation",
    "static-site",
    "agents"
  ],
  "related": [
    "getting-started",
    "configuration",
    "content-model",
    "agent-interface",
    "publishing",
    "large-canvas"
  ],
  "sourceRefs": [
    "../../README.md",
    "../../package.json"
  ],
  "authors": [],
  "updated": null,
  "diagram": "publication-flow",
  "body": "## Documentation without a second source of truth\n\nAurelius starts with versioned Markdown and JSON. One build publishes that knowledge as an accessible static site, recoverable Markdown, and a small JSON API for agents. Your content is not trapped in a CMS, database, or proprietary editor.\n\nThe [Aurelius repository on GitHub](https://github.com/ArthurWillers/Aurelius) contains the generator, examples, tests, and the source for this documentation.\n\n{{diagram:publication-flow}}\n\n## Install it and create your first site\n\nInstall the newest semver-tagged GitHub release as a development dependency. npm resolves it when you run the command; the lockfile pins that commit for local work and CI:\n\n```bash\nnpm install --save-dev github:ArthurWillers/Aurelius#semver:*\nnpx --no-install aurelius init docs --title \"Product documentation\" --logo brand.svg\nnpx --no-install aurelius check --site docs\nnpx --no-install aurelius build --site docs\n```\n\nClone the generator only when contributing or customizing it. `init` creates two pages, an editable visual identity, and a diagram. Continue with [Installation and commands](doc:getting-started) for the complete workflow.\n\n## What a build publishes\n\n- Accessible static HTML with search, layered navigation, print styling, and Markdown copy.\n- Markdown files in `markdown/` and a linear corpus in `llms-full.txt`.\n- JSON discovery through `api/manifest.json`, `api/index.json`, `api/search.json`, and `api/graph.json`.\n- Declarative architecture diagrams, large navigable Canvases, accessible SVG, and isolated authored HTML visuals with semantic equivalents for agents.\n\nRead [Site configuration](doc:configuration), [Content and diagram model](doc:content-model), and [Agent interfaces](doc:agent-interface) before publishing.",
  "sections": [
    {
      "id": "documentation-without-a-second-source-of-truth",
      "level": 2,
      "title": "Documentation without a second source of truth",
      "text": "Aurelius starts with versioned Markdown and JSON. One build publishes that knowledge as an accessible static site, recoverable Markdown, and a small JSON API for agents. Your content is not trapped in a CMS, database, or proprietary editor.  The [Aurelius repository on GitHub](https://github.com/ArthurWillers/Aurelius) contains the generator, examples, tests, and the source for this documentation.",
      "line": 1
    },
    {
      "id": "install-it-and-create-your-first-site",
      "level": 2,
      "title": "Install it and create your first site",
      "text": "Install the newest semver-tagged GitHub release as a development dependency. npm resolves it when you run the command; the lockfile pins that commit for local work and CI:   Clone the generator only when contributing or customizing it. `init` creates two pages, an editable visual identity, and a diagram. Continue with [Installation and commands](doc:getting-started) for the complete workflow.",
      "line": 9
    },
    {
      "id": "what-a-build-publishes",
      "level": 2,
      "title": "What a build publishes",
      "text": "- Accessible static HTML with search, layered navigation, print styling, and Markdown copy. - Markdown files in `markdown/` and a linear corpus in `llms-full.txt`. - JSON discovery through `api/manifest.json`, `api/index.json`, `api/search.json`, and `api/graph.json`. - Declarative architecture diagrams, large navigable Canvases, accessible SVG, and isolated authored HTML visuals with semantic equivalents for agents.  Read [Site configuration](doc:configuration), [Content and diagram model](doc:content-model), and [Agent interfaces](doc:agent-interface) before publishing.",
      "line": 22
    }
  ],
  "sourcePath": "content/home.md",
  "visuals": [
    {
      "id": "publication-flow",
      "kind": "architecture",
      "title": "From source to reader",
      "description": "Markdown and technical references pass through one build and become an editorial page, a JSON API, and an agent-readable corpus.",
      "summary": "Markdown and technical references pass through one build and become an editorial page, a JSON API, and an agent-readable corpus.",
      "renderMode": "native",
      "api": "api/diagrams/publication-flow.json",
      "human": "diagrams/publication-flow.html"
    }
  ],
  "apiVersion": 1
}