# jasontaylordev/cleanarchitecture architecture

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

- Interactive diagram: https://gitdiagram.com/jasontaylordev/cleanarchitecture
- Repository: https://github.com/jasontaylordev/cleanarchitecture

## Overview

This is a Clean Architecture application template: a user manages task lists and items through an Angular or React client, with ASP.NET endpoints dispatching application operations and infrastructure persisting the domain model. It also includes authentication, authorization, and weather features. The graph retains both documented client choices and the sampled todo, identity, and persistence layers; unsampled endpoint and client behavior is not expanded beyond relationships evidenced by the excerpts or source index.

Main entry points: [`src/Infrastructure/Data/ApplicationDbContext.cs`](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Infrastructure/Data/ApplicationDbContext.cs) (EF database), [`src/Web/Endpoints/TodoLists.cs`](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/Endpoints/TodoLists.cs) (Todo endpoints), [`src/Web/ClientApp/src/app/app.module.ts`](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/ClientApp/src/app/app.module.ts) (Angular client), [`src/Web/ClientApp-React/src/AppRoutes.jsx`](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/ClientApp-React/src/AppRoutes.jsx) (React client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Web clients"]
  node_angular["Angular client<br/>[app.module.ts]"]
  node_angular_auth["Angular auth<br/>[auth.service.ts]"]
  node_react["React client<br/>[AppRoutes.jsx]"]
  node_react_auth["React auth<br/>[AuthContext.jsx]"]
end

subgraph group_web["HTTP API"]
  node_todo_api["Todo endpoints<br/>[TodoLists.cs]"]
  node_weather_api["Weather endpoint"]
  node_users_api["User endpoints<br/>[Users.cs]"]
end

subgraph group_app["Application"]
  node_todo_commands["Todo commands"]
  node_todo_queries["Todo queries<br/>[GetTodos.cs]"]
  node_weather_query["Weather query"]
  node_identity_contract["Identity contract"]
  node_db_contract["Persistence contract"]
end

subgraph group_core["Domain and infrastructure"]
  node_todo_domain["Todo model<br/>[TodoItem.cs]"]
  node_todo_list["Todo lists<br/>[TodoList.cs]"]
  node_colour["List colours<br/>[Colour.cs]"]
  node_db_context[("EF database")]
  node_identity["Identity service<br/>[IdentityService.cs]"]
  node_db_init["Database seeding"]
end

node_user(("User"))

node_user -->|"uses"| node_angular
node_user -->|"uses"| node_react
node_angular -->|"initializes"| node_angular_auth
node_react -->|"provides auth"| node_react_auth
node_angular -.->|"requests"| node_todo_api
node_react -.->|"requests"| node_todo_api
node_todo_api -->|"dispatches"| node_todo_commands
node_todo_api -->|"dispatches"| node_todo_queries
node_weather_api -->|"dispatches"| node_weather_query
node_users_api -.->|"uses"| node_identity
node_identity -->|"implements"| node_identity_contract
node_todo_domain -->|"models stored data"| node_db_contract
node_todo_list -->|"models stored data"| node_db_contract
node_db_context -->|"implements"| node_db_contract
node_db_context -->|"maps"| node_todo_domain
node_db_context -->|"maps"| node_todo_list
node_todo_list -->|"uses"| node_colour
node_db_init -->|"initializes"| node_db_context

click node_angular "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/ClientApp/src/app/app.module.ts"
click node_angular_auth "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/ClientApp/src/api-authorization/auth.service.ts"
click node_react "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/ClientApp-React/src/AppRoutes.jsx"
click node_react_auth "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/ClientApp-React/src/components/api-authorization/AuthContext.jsx"
click node_todo_api "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/Endpoints/TodoLists.cs"
click node_weather_api "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/Endpoints/WeatherForecasts.cs"
click node_users_api "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/Endpoints/Users.cs"
click node_todo_commands "https://github.com/jasontaylordev/cleanarchitecture/tree/main/src/Application/TodoItems/Commands"
click node_todo_queries "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Application/TodoLists/Queries/GetTodos/GetTodos.cs"
click node_weather_query "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Application/WeatherForecasts/Queries/GetWeatherForecasts/GetWeatherForecastsQuery.cs"
click node_identity_contract "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Application/Common/Interfaces/IIdentityService.cs"
click node_db_contract "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Application/Common/Interfaces/IApplicationDbContext.cs"
click node_todo_domain "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Domain/Entities/TodoItem.cs"
click node_todo_list "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Domain/Entities/TodoList.cs"
click node_colour "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Domain/ValueObjects/Colour.cs"
click node_db_context "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Infrastructure/Data/ApplicationDbContext.cs"
click node_identity "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Infrastructure/Identity/IdentityService.cs"
click node_db_init "https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Infrastructure/Data/ApplicationDbContextInitialiser.cs"

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_angular,node_angular_auth,node_react,node_react_auth,node_user toneBlue
class node_todo_api,node_weather_api,node_users_api toneAmber
class node_todo_commands,node_todo_queries,node_weather_query,node_identity_contract,node_db_contract toneMint
class node_todo_domain,node_todo_list,node_colour,node_db_context,node_identity,node_db_init toneRose
```

## Components

### Web clients

- [Angular client](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/ClientApp/src/app/app.module.ts): `src/Web/ClientApp/src/app/app.module.ts`
- [Angular auth](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/ClientApp/src/api-authorization/auth.service.ts): `src/Web/ClientApp/src/api-authorization/auth.service.ts`
- [React client](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/ClientApp-React/src/AppRoutes.jsx): `src/Web/ClientApp-React/src/AppRoutes.jsx`
- [React auth](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/ClientApp-React/src/components/api-authorization/AuthContext.jsx): `src/Web/ClientApp-React/src/components/api-authorization/AuthContext.jsx`

### HTTP API

- [Todo endpoints](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/Endpoints/TodoLists.cs): `src/Web/Endpoints/TodoLists.cs`
- [Weather endpoint](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/Endpoints/WeatherForecasts.cs): `src/Web/Endpoints/WeatherForecasts.cs`
- [User endpoints](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Web/Endpoints/Users.cs): `src/Web/Endpoints/Users.cs`

### Application

- [Todo commands](https://github.com/jasontaylordev/cleanarchitecture/tree/main/src/Application/TodoItems/Commands): `src/Application/TodoItems/Commands`
- [Todo queries](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Application/TodoLists/Queries/GetTodos/GetTodos.cs): `src/Application/TodoLists/Queries/GetTodos/GetTodos.cs`
- [Weather query](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Application/WeatherForecasts/Queries/GetWeatherForecasts/GetWeatherForecastsQuery.cs): `src/Application/WeatherForecasts/Queries/GetWeatherForecasts/GetWeatherForecastsQuery.cs`
- [Identity contract](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Application/Common/Interfaces/IIdentityService.cs): `src/Application/Common/Interfaces/IIdentityService.cs`
- [Persistence contract](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Application/Common/Interfaces/IApplicationDbContext.cs): `src/Application/Common/Interfaces/IApplicationDbContext.cs`

### Domain and infrastructure

- [Todo model](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Domain/Entities/TodoItem.cs): `src/Domain/Entities/TodoItem.cs`
- [Todo lists](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Domain/Entities/TodoList.cs): `src/Domain/Entities/TodoList.cs`
- [List colours](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Domain/ValueObjects/Colour.cs): `src/Domain/ValueObjects/Colour.cs`
- [EF database](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Infrastructure/Data/ApplicationDbContext.cs): `src/Infrastructure/Data/ApplicationDbContext.cs`
- [Identity service](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Infrastructure/Identity/IdentityService.cs): `src/Infrastructure/Identity/IdentityService.cs`
- [Database seeding](https://github.com/jasontaylordev/cleanarchitecture/blob/main/src/Infrastructure/Data/ApplicationDbContextInitialiser.cs): `src/Infrastructure/Data/ApplicationDbContextInitialiser.cs`

### Other components

- **User**

## Connections

- User → Angular client: uses
- User → React client: uses
- Angular client → Angular auth: initializes (evidence: `src/Web/ClientApp/src/app/app.module.ts`)
- React client → React auth: provides auth (evidence: `src/Web/ClientApp-React/src/App.jsx`)
- Angular client → Todo endpoints: requests
- React client → Todo endpoints: requests
- Todo endpoints → Todo commands: dispatches (evidence: `src/Web/Endpoints/TodoLists.cs`)
- Todo endpoints → Todo queries: dispatches (evidence: `src/Web/Endpoints/TodoLists.cs`)
- Weather endpoint → Weather query: dispatches (evidence: `src/Application/WeatherForecasts/Queries/GetWeatherForecasts/GetWeatherForecastsQuery.cs`)
- User endpoints → Identity service: uses
- Identity service → Identity contract: implements (evidence: `src/Infrastructure/Identity/IdentityService.cs`)
- Todo model → Persistence contract: models stored data (evidence: `src/Application/Common/Interfaces/IApplicationDbContext.cs`)
- Todo lists → Persistence contract: models stored data (evidence: `src/Application/Common/Interfaces/IApplicationDbContext.cs`)
- EF database → Persistence contract: implements (evidence: `src/Infrastructure/Data/ApplicationDbContext.cs`)
- EF database → Todo model: maps (evidence: `src/Infrastructure/Data/ApplicationDbContext.cs`)
- EF database → Todo lists: maps (evidence: `src/Infrastructure/Data/ApplicationDbContext.cs`)
- Todo lists → List colours: uses (evidence: `src/Domain/Entities/TodoList.cs`)
- Database seeding → EF database: initializes (evidence: `src/Infrastructure/Data/ApplicationDbContextInitialiser.cs`)
