# jaisgautam/the-developer architecture

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

- Interactive diagram: https://gitdiagram.com/jaisgautam/the-developer
- Repository: https://github.com/jaisgautam/the-developer

## Overview

AURA is a decentralized storage network with a Rust node/CLI/SDK and a React dashboard. The principal documented workflow is starting a node, which runs as a daemon; storage uses content-addressed chunking and a write-ahead log, while network capabilities provide peer discovery and DHT routing. The README documents these capabilities but does not show their runtime wiring. The graph therefore limits solid edges to visible calls and documented relationships; dashed edges indicate architecture links whose implementation was not sampled.

Main entry points: [`crates/aura-node/src/services`](https://github.com/jaisgautam/the-developer/tree/main/crates/aura-node/src/services) (Node services), [`frontend/src/App.tsx`](https://github.com/jaisgautam/the-developer/blob/main/frontend/src/App.tsx) (Dashboard application), [`crates/aura-node/src/daemon.rs`](https://github.com/jaisgautam/the-developer/blob/main/crates/aura-node/src/daemon.rs) (Node daemon), [`crates/aura-storage/src/cas`](https://github.com/jaisgautam/the-developer/tree/main/crates/aura-storage/src/cas) (CAS chunking and store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry points"]
  node_cli["AURA CLI<br/>[main.rs]"]
  node_start["Start command<br/>[start.rs]"]
  node_sdk["SDK client<br/>[client.rs]"]
  node_stream["Stream pipeline<br/>[stream.rs]"]
end

subgraph group_runtime["Node runtime"]
  node_daemon["Node daemon<br/>[daemon.rs]"]
  node_services["Node services"]
  node_eventbus["Event bus<br/>[event_bus.rs]"]
  node_gateway["Node gateway<br/>[gateway.rs]"]
  node_model["Data model"]
  node_capabilities["Capability tokens<br/>[capabilities.rs]"]
end

subgraph group_storage["Storage pipeline"]
  node_cas[("CAS chunking and store")]
  node_gc["Storage garbage collection<br/>[gc.rs]"]
  node_wal[("Write-ahead log")]
  node_kv[("Key-value adapters")]
end

subgraph group_network["Network and security"]
  node_network["Peer transport and DHT"]
  node_crypto["Cryptography"]
end

subgraph group_frontend["Web dashboard"]
  node_web["Dashboard application<br/>[App.tsx]"]
  node_auth["Authentication state<br/>[authStore.ts]"]
  node_login["Login and signup"]
  node_api["Frontend API client<br/>[api.ts]"]
  node_dashboard["Dashboard pages"]
end

node_operator(("Node operator"))
node_browser(("Dashboard user"))

node_operator -.->|"runs"| node_cli
node_cli -->|"dispatches"| node_start
node_start -->|"starts"| node_daemon
node_sdk -->|"processes through"| node_stream
node_daemon -->|"uses"| node_services
node_daemon -->|"uses"| node_eventbus
node_services -.->|"uses storage"| node_cas
node_services -.->|"uses network"| node_network
node_services -.->|"uses models"| node_model
node_gateway -.->|"dispatches to"| node_services
node_cas -.->|"uses BLAKE3 IDs"| node_crypto
node_cas -.->|"chunks data"| node_model
node_wal -.->|"persists state"| node_kv
node_network -.->|"uses S/Kademlia"| node_crypto
node_browser -.->|"opens"| node_web
node_web -->|"reads token"| node_auth
node_web -->|"routes to"| node_login
node_web -.->|"renders"| node_dashboard
node_dashboard -.->|"requests data"| node_api

click node_cli "https://github.com/jaisgautam/the-developer/blob/main/crates/aura-cli/src/main.rs"
click node_start "https://github.com/jaisgautam/the-developer/blob/main/crates/aura-cli/src/commands/start.rs"
click node_sdk "https://github.com/jaisgautam/the-developer/blob/main/crates/aura-sdk/src/client.rs"
click node_stream "https://github.com/jaisgautam/the-developer/blob/main/crates/aura-sdk/src/stream.rs"
click node_daemon "https://github.com/jaisgautam/the-developer/blob/main/crates/aura-node/src/daemon.rs"
click node_services "https://github.com/jaisgautam/the-developer/tree/main/crates/aura-node/src/services"
click node_eventbus "https://github.com/jaisgautam/the-developer/blob/main/crates/aura-node/src/event_bus.rs"
click node_gateway "https://github.com/jaisgautam/the-developer/blob/main/crates/aura-node/src/gateway.rs"
click node_model "https://github.com/jaisgautam/the-developer/tree/main/crates/aura-data-model/src"
click node_capabilities "https://github.com/jaisgautam/the-developer/blob/main/crates/aura-core/src/capabilities.rs"
click node_cas "https://github.com/jaisgautam/the-developer/tree/main/crates/aura-storage/src/cas"
click node_gc "https://github.com/jaisgautam/the-developer/blob/main/crates/aura-storage/src/gc.rs"
click node_wal "https://github.com/jaisgautam/the-developer/tree/main/crates/aura-storage/src/wal"
click node_kv "https://github.com/jaisgautam/the-developer/tree/main/crates/aura-storage/src/kv"
click node_network "https://github.com/jaisgautam/the-developer/tree/main/crates/aura-network/src"
click node_crypto "https://github.com/jaisgautam/the-developer/tree/main/crates/aura-crypto/src"
click node_web "https://github.com/jaisgautam/the-developer/blob/main/frontend/src/App.tsx"
click node_auth "https://github.com/jaisgautam/the-developer/blob/main/frontend/src/lib/authStore.ts"
click node_login "https://github.com/jaisgautam/the-developer/tree/main/frontend/src/Pages"
click node_api "https://github.com/jaisgautam/the-developer/blob/main/frontend/src/lib/api.ts"
click node_dashboard "https://github.com/jaisgautam/the-developer/tree/main/frontend/src/Pages"

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_cli,node_start,node_sdk,node_stream,node_browser toneBlue
class node_daemon,node_services,node_eventbus,node_gateway,node_model,node_capabilities toneAmber
class node_cas,node_gc,node_wal,node_kv toneMint
class node_network,node_crypto toneRose
class node_web,node_auth,node_login,node_api,node_dashboard,node_operator toneIndigo
```

## Components

### User entry points

- [AURA CLI](https://github.com/jaisgautam/the-developer/blob/main/crates/aura-cli/src/main.rs): `crates/aura-cli/src/main.rs`
- [Start command](https://github.com/jaisgautam/the-developer/blob/main/crates/aura-cli/src/commands/start.rs): `crates/aura-cli/src/commands/start.rs`
- [SDK client](https://github.com/jaisgautam/the-developer/blob/main/crates/aura-sdk/src/client.rs): `crates/aura-sdk/src/client.rs`
- [Stream pipeline](https://github.com/jaisgautam/the-developer/blob/main/crates/aura-sdk/src/stream.rs): `crates/aura-sdk/src/stream.rs`

### Node runtime

- [Node daemon](https://github.com/jaisgautam/the-developer/blob/main/crates/aura-node/src/daemon.rs): `crates/aura-node/src/daemon.rs`
- [Node services](https://github.com/jaisgautam/the-developer/tree/main/crates/aura-node/src/services): `crates/aura-node/src/services`
- [Event bus](https://github.com/jaisgautam/the-developer/blob/main/crates/aura-node/src/event_bus.rs): `crates/aura-node/src/event_bus.rs`
- [Node gateway](https://github.com/jaisgautam/the-developer/blob/main/crates/aura-node/src/gateway.rs): `crates/aura-node/src/gateway.rs`
- [Data model](https://github.com/jaisgautam/the-developer/tree/main/crates/aura-data-model/src): `crates/aura-data-model/src`
- [Capability tokens](https://github.com/jaisgautam/the-developer/blob/main/crates/aura-core/src/capabilities.rs): `crates/aura-core/src/capabilities.rs`

### Storage pipeline

- [CAS chunking and store](https://github.com/jaisgautam/the-developer/tree/main/crates/aura-storage/src/cas): `crates/aura-storage/src/cas`
- [Storage garbage collection](https://github.com/jaisgautam/the-developer/blob/main/crates/aura-storage/src/gc.rs): `crates/aura-storage/src/gc.rs`
- [Write-ahead log](https://github.com/jaisgautam/the-developer/tree/main/crates/aura-storage/src/wal): `crates/aura-storage/src/wal`
- [Key-value adapters](https://github.com/jaisgautam/the-developer/tree/main/crates/aura-storage/src/kv): `crates/aura-storage/src/kv`

### Network and security

- [Peer transport and DHT](https://github.com/jaisgautam/the-developer/tree/main/crates/aura-network/src): `crates/aura-network/src`
- [Cryptography](https://github.com/jaisgautam/the-developer/tree/main/crates/aura-crypto/src): `crates/aura-crypto/src`

### Web dashboard

- [Dashboard application](https://github.com/jaisgautam/the-developer/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Authentication state](https://github.com/jaisgautam/the-developer/blob/main/frontend/src/lib/authStore.ts): `frontend/src/lib/authStore.ts`
- [Login and signup](https://github.com/jaisgautam/the-developer/tree/main/frontend/src/Pages): `frontend/src/Pages`
- [Frontend API client](https://github.com/jaisgautam/the-developer/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [Dashboard pages](https://github.com/jaisgautam/the-developer/tree/main/frontend/src/Pages): `frontend/src/Pages`

### Other components

- **Node operator**
- **Dashboard user**

## Connections

- Node operator → AURA CLI: runs
- AURA CLI → Start command: dispatches (evidence: `crates/aura-cli/src/main.rs`)
- Start command → Node daemon: starts (evidence: `crates/aura-cli/src/commands/start.rs`)
- SDK client → Stream pipeline: processes through (evidence: `crates/aura-sdk/src/client.rs`)
- Node daemon → Node services: uses (evidence: `crates/aura-node/src/daemon.rs`)
- Node daemon → Event bus: uses (evidence: `crates/aura-node/src/daemon.rs`)
- Node services → CAS chunking and store: uses storage
- Node services → Peer transport and DHT: uses network
- Node services → Data model: uses models
- Node gateway → Node services: dispatches to
- CAS chunking and store → Cryptography: uses BLAKE3 IDs
- CAS chunking and store → Data model: chunks data
- Write-ahead log → Key-value adapters: persists state
- Peer transport and DHT → Cryptography: uses S/Kademlia
- Dashboard user → Dashboard application: opens
- Dashboard application → Authentication state: reads token (evidence: `frontend/src/App.tsx`)
- Dashboard application → Login and signup: routes to (evidence: `frontend/src/App.tsx`)
- Dashboard application → Dashboard pages: renders
- Dashboard pages → Frontend API client: requests data
