# cordiverse/paper architecture

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

- Interactive diagram: https://gitdiagram.com/cordiverse/paper
- Repository: https://github.com/cordiverse/paper

## Overview

This repository snapshot contains only a README describing a research preprint and the Cordis framework; no implementation tree or source excerpts are available. The graph therefore captures documented concepts and product capabilities, not verified internal call wiring.

Main entry points: [`README.md`](https://github.com/cordiverse/paper/blob/main/README.md) (Component Loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_paradigm["Composition Paradigm"]
  node_context["Unified Context<br/>[README.md]"]
  node_effects["Revertible Effects<br/>[README.md]"]
  node_coeffects["Reactive Coeffects<br/>[README.md]"]
  node_components["Dynamic Components<br/>[README.md]"]
end

subgraph group_cordis["Cordis Framework"]
  node_core["Core Library<br/>[README.md]"]
  node_loader["Component Loader<br/>[README.md]"]
  node_reconcile["Configuration Reconciliation<br/>[README.md]"]
  node_hmr["Hot Module Replacement<br/>[README.md]"]
end

node_engineer(("Framework User"))

node_engineer -->|"declares components"| node_loader
node_loader -->|"loads"| node_components
node_components -->|"uses"| node_core
node_core -->|"tracks effects"| node_effects
node_core -->|"resolves coeffects"| node_coeffects
node_effects -->|"mediate through"| node_context
node_coeffects -->|"mediate through"| node_context
node_loader -->|"reconciles configuration"| node_reconcile
node_loader -->|"supports replacement"| node_hmr

click node_context "https://github.com/cordiverse/paper/blob/main/README.md"
click node_effects "https://github.com/cordiverse/paper/blob/main/README.md"
click node_coeffects "https://github.com/cordiverse/paper/blob/main/README.md"
click node_components "https://github.com/cordiverse/paper/blob/main/README.md"
click node_core "https://github.com/cordiverse/paper/blob/main/README.md"
click node_loader "https://github.com/cordiverse/paper/blob/main/README.md"
click node_reconcile "https://github.com/cordiverse/paper/blob/main/README.md"
click node_hmr "https://github.com/cordiverse/paper/blob/main/README.md"

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_context,node_effects,node_coeffects,node_components,node_engineer toneBlue
class node_core,node_loader,node_reconcile,node_hmr toneAmber
```

## Components

### Composition Paradigm

- [Unified Context](https://github.com/cordiverse/paper/blob/main/README.md): `README.md`
- [Revertible Effects](https://github.com/cordiverse/paper/blob/main/README.md): `README.md`
- [Reactive Coeffects](https://github.com/cordiverse/paper/blob/main/README.md): `README.md`
- [Dynamic Components](https://github.com/cordiverse/paper/blob/main/README.md): `README.md`

### Cordis Framework

- [Core Library](https://github.com/cordiverse/paper/blob/main/README.md): `README.md`
- [Component Loader](https://github.com/cordiverse/paper/blob/main/README.md): `README.md`
- [Configuration Reconciliation](https://github.com/cordiverse/paper/blob/main/README.md): `README.md`
- [Hot Module Replacement](https://github.com/cordiverse/paper/blob/main/README.md): `README.md`

### Other components

- **Framework User**

## Connections

- Framework User → Component Loader: declares components
- Component Loader → Dynamic Components: loads
- Dynamic Components → Core Library: uses
- Core Library → Revertible Effects: tracks effects
- Core Library → Reactive Coeffects: resolves coeffects
- Revertible Effects → Unified Context: mediate through
- Reactive Coeffects → Unified Context: mediate through
- Component Loader → Configuration Reconciliation: reconciles configuration
- Component Loader → Hot Module Replacement: supports replacement