# shiavault/shiavault-library architecture

> Architecture diagram of the GitHub repository shiavault/shiavault-library, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shiavault/shiavault-library
- Repository: https://github.com/shiavault/shiavault-library

## Overview

Shiavault Library is a collaborative Markdown book corpus used by Shiavault.com to serve book pages. Readers reach the books through that site; contributors add books or revise chapters and metadata through repository changes. The README documents chapters and metadata as distinct content stages, but no source excerpts or individual book files were provided, so the graph shows only documented relationships and uses the existing `books/` directory for those content nodes.

Main entry points: [`books`](https://github.com/shiavault/shiavault-library/tree/master/books) (Markdown chapters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Book content"]
  node_chapters["Markdown chapters"]
  node_metadata["Book metadata"]
end

subgraph group_access["Access and contribution"]
  node_site["Shiavault.com"]
end

node_readers(("Readers"))
node_contributors(("Contributors"))

node_contributors -->|"edit or add"| node_chapters
node_contributors -->|"maintain"| node_metadata
node_site -->|"serves books"| node_chapters
node_site -->|"uses book information"| node_metadata
node_readers -.->|"access books"| node_site

click node_chapters "https://github.com/shiavault/shiavault-library/tree/master/books"
click node_metadata "https://github.com/shiavault/shiavault-library/tree/master/books"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_chapters,node_metadata toneBlue
class node_site toneAmber
class node_readers,node_contributors toneIndigo
```

## Components

### Book content

- [Markdown chapters](https://github.com/shiavault/shiavault-library/tree/master/books): `books`
- [Book metadata](https://github.com/shiavault/shiavault-library/tree/master/books): `books`

### Access and contribution

- **Shiavault.com**

### Other components

- **Readers**
- **Contributors**

## Connections

- Contributors → Markdown chapters: edit or add (evidence: `README.md`)
- Contributors → Book metadata: maintain (evidence: `README.md`)
- Shiavault.com → Markdown chapters: serves books (evidence: `README.md`)
- Shiavault.com → Book metadata: uses book information (evidence: `README.md`)
- Readers → Shiavault.com: access books
