# howtocodeit/hexarch architecture

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

- Interactive diagram: https://gitdiagram.com/howtocodeit/hexarch
- Repository: https://github.com/howtocodeit/hexarch

## Overview

This repository provides code for a Rust hexagonal-architecture guide, organized into three branches: a deliberately poor app, an improved app that separates repositories from HTTP handlers, and a simple-service template. The supplied tree contains no source files, so runtime components and their call relationships cannot be verified; the graph is limited to the documented branch distinctions.

Main entry points: [`README.md`](https://github.com/howtocodeit/hexarch/blob/main/README.md) (Repository README)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_readme["Repository README<br/>[README.md]"]
node_bad_app["Very bad app"]
node_better_app["Separated repository"]
node_simple_service["Simple service"]

node_readme -->|"describes branch"| node_bad_app
node_readme -->|"describes branch"| node_better_app
node_readme -->|"describes branch"| node_simple_service

click node_readme "https://github.com/howtocodeit/hexarch/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_readme toneTeal
class node_bad_app,node_better_app,node_simple_service toneIndigo
```

## Components

### Other components

- [Repository README](https://github.com/howtocodeit/hexarch/blob/main/README.md): `README.md`
- **Very bad app**
- **Separated repository**
- **Simple service**

## Connections

- Repository README → Very bad app: describes branch
- Repository README → Separated repository: describes branch
- Repository README → Simple service: describes branch