# samyam-pradhan/flask-app architecture

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

- Interactive diagram: https://gitdiagram.com/samyam-pradhan/flask-app
- Repository: https://github.com/samyam-pradhan/flask-app

## Overview

This is a small Flask site with four page routes, alongside a documented Docker, GitHub Actions, Kubernetes, and Argo CD deployment workflow. The sampled app source confirms the route-to-template rendering; deployment wiring is based on the README and manifest names, since their contents were not sampled.

Main entry points: [`app.py`](https://github.com/samyam-pradhan/flask-app/blob/main/app.py) (Flask routes), [`k8s/manifests/deployment.yaml`](https://github.com/samyam-pradhan/flask-app/blob/main/k8s/manifests/deployment.yaml) (Kubernetes deployment), [`.github/workflows/ci.yaml`](https://github.com/samyam-pradhan/flask-app/blob/main/.github/workflows/ci.yaml) (GitHub Actions), [`k8s/manifests/service.yaml`](https://github.com/samyam-pradhan/flask-app/blob/main/k8s/manifests/service.yaml) (Kubernetes service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_flask["Flask routes<br/>[app.py]"]
  node_home["Home page<br/>[index.html]"]
  node_articles["Articles page<br/>[articles.html]"]
  node_categories["Categories page<br/>[categories.html]"]
  node_about["About page<br/>[about.html]"]
end

subgraph group_delivery["Delivery workflow"]
  node_docker["Docker packaging"]
  node_actions["GitHub Actions<br/>[ci.yaml]"]
  node_argocd["Argo CD"]
end

subgraph group_cluster["Kubernetes runtime"]
  node_deployment["Kubernetes deployment<br/>[deployment.yaml]"]
  node_service["Kubernetes service<br/>[service.yaml]"]
  node_ingress["Kubernetes ingress<br/>[ingress.yaml]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"requests pages"| node_flask
node_flask -->|"renders"| node_home
node_flask -->|"renders"| node_articles
node_flask -->|"renders"| node_categories
node_flask -->|"renders"| node_about
node_flask -->|"returns page"| node_visitor
node_actions -.->|"uses packaging"| node_docker
node_actions -.->|"deploys"| node_deployment
node_argocd -.->|"syncs manifests"| node_deployment
node_ingress -->|"routes traffic"| node_service
node_service -->|"targets pods"| node_deployment
node_deployment -->|"runs app"| node_flask

click node_flask "https://github.com/samyam-pradhan/flask-app/blob/main/app.py"
click node_home "https://github.com/samyam-pradhan/flask-app/blob/main/templates/index.html"
click node_articles "https://github.com/samyam-pradhan/flask-app/blob/main/templates/articles.html"
click node_categories "https://github.com/samyam-pradhan/flask-app/blob/main/templates/categories.html"
click node_about "https://github.com/samyam-pradhan/flask-app/blob/main/templates/about.html"
click node_docker "https://github.com/samyam-pradhan/flask-app/blob/main/Dockerfile"
click node_actions "https://github.com/samyam-pradhan/flask-app/blob/main/.github/workflows/ci.yaml"
click node_deployment "https://github.com/samyam-pradhan/flask-app/blob/main/k8s/manifests/deployment.yaml"
click node_service "https://github.com/samyam-pradhan/flask-app/blob/main/k8s/manifests/service.yaml"
click node_ingress "https://github.com/samyam-pradhan/flask-app/blob/main/k8s/manifests/ingress.yaml"

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_flask,node_home,node_articles,node_categories,node_about toneBlue
class node_docker,node_actions,node_argocd toneAmber
class node_deployment,node_service,node_ingress toneMint
class node_visitor toneIndigo
```

## Components

### Web application

- [Flask routes](https://github.com/samyam-pradhan/flask-app/blob/main/app.py): `app.py`
- [Home page](https://github.com/samyam-pradhan/flask-app/blob/main/templates/index.html): `templates/index.html`
- [Articles page](https://github.com/samyam-pradhan/flask-app/blob/main/templates/articles.html): `templates/articles.html`
- [Categories page](https://github.com/samyam-pradhan/flask-app/blob/main/templates/categories.html): `templates/categories.html`
- [About page](https://github.com/samyam-pradhan/flask-app/blob/main/templates/about.html): `templates/about.html`

### Delivery workflow

- [Docker packaging](https://github.com/samyam-pradhan/flask-app/blob/main/Dockerfile): `Dockerfile`
- [GitHub Actions](https://github.com/samyam-pradhan/flask-app/blob/main/.github/workflows/ci.yaml): `.github/workflows/ci.yaml`
- **Argo CD**

### Kubernetes runtime

- [Kubernetes deployment](https://github.com/samyam-pradhan/flask-app/blob/main/k8s/manifests/deployment.yaml): `k8s/manifests/deployment.yaml`
- [Kubernetes service](https://github.com/samyam-pradhan/flask-app/blob/main/k8s/manifests/service.yaml): `k8s/manifests/service.yaml`
- [Kubernetes ingress](https://github.com/samyam-pradhan/flask-app/blob/main/k8s/manifests/ingress.yaml): `k8s/manifests/ingress.yaml`

### Other components

- **Site visitor**

## Connections

- Site visitor → Flask routes: requests pages
- Flask routes → Home page: renders
- Flask routes → Articles page: renders
- Flask routes → Categories page: renders
- Flask routes → About page: renders
- Flask routes → Site visitor: returns page
- GitHub Actions → Docker packaging: uses packaging
- GitHub Actions → Kubernetes deployment: deploys
- Argo CD → Kubernetes deployment: syncs manifests
- Kubernetes ingress → Kubernetes service: routes traffic
- Kubernetes service → Kubernetes deployment: targets pods
- Kubernetes deployment → Flask routes: runs app
