# crkr-dev/mern-k8s-demo architecture

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

- Interactive diagram: https://gitdiagram.com/crkr-dev/mern-k8s-demo
- Repository: https://github.com/crkr-dev/mern-k8s-demo

## Overview

MERN Kubernetes Demo is a small message-editing app and a deployment-learning example. A user loads the React page, which reads a message from the Express API and can submit an update; the API persists messages in MongoDB. The repository also provides local Compose, raw Kubernetes, and Helm deployment options, plus documented GitHub Actions image publishing and deployment workflows. Runtime links are supported by the sampled source; deployment capabilities and relationships are based on the README, not inspection of those configuration files.

Main entry points: [`frontend/src/App.jsx`](https://github.com/crkr-dev/mern-k8s-demo/blob/main/frontend/src/App.jsx) (Message page), [`helm/mern-k8s-demo`](https://github.com/crkr-dev/mern-k8s-demo/tree/main/helm/mern-k8s-demo) (Helm chart), [`backend/src/server.js`](https://github.com/crkr-dev/mern-k8s-demo/blob/main/backend/src/server.js) (Express API), [`docker-compose.yml`](https://github.com/crkr-dev/mern-k8s-demo/blob/main/docker-compose.yml) (Compose setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Message app"]
  node_bootstrap["React bootstrap<br/>[main.jsx]"]
  node_page["Message page<br/>[App.jsx]"]
end

subgraph group_runtime["API and storage"]
  node_api["Express API<br/>[server.js]"]
  node_messages["Message persistence<br/>[server.js]"]
  node_mongo[("MongoDB")]
end

subgraph group_deploy["Deployment options"]
  node_compose["Compose setup<br/>[docker-compose.yml]"]
  node_manifests["Kubernetes manifests"]
  node_helm["Helm chart"]
end

subgraph group_automation["Image automation"]
  node_image_workflow["Image workflow<br/>[build-and-push.yml]"]
  node_local_deploy_workflow["Local deploy workflow"]
  node_ghcr["GitHub Container Registry"]
end

node_user(("Page user"))

node_user -->|"uses"| node_page
node_bootstrap -->|"renders"| node_page
node_page -->|"requests message"| node_api
node_api -->|"reads or creates"| node_messages
node_messages -->|"persists messages"| node_mongo
node_compose -->|"runs app locally"| node_page
node_compose -->|"runs app locally"| node_api
node_compose -->|"runs app locally"| node_mongo
node_manifests -->|"deploys app"| node_page
node_manifests -->|"deploys app"| node_api
node_manifests -->|"deploys app"| node_mongo
node_helm -->|"deploys app"| node_page
node_helm -->|"deploys app"| node_api
node_helm -->|"deploys app"| node_mongo
node_image_workflow -->|"publishes images"| node_ghcr
node_image_workflow -->|"deploys images"| node_helm
node_local_deploy_workflow -->|"runs deployment"| node_helm

click node_bootstrap "https://github.com/crkr-dev/mern-k8s-demo/blob/main/frontend/src/main.jsx"
click node_page "https://github.com/crkr-dev/mern-k8s-demo/blob/main/frontend/src/App.jsx"
click node_api "https://github.com/crkr-dev/mern-k8s-demo/blob/main/backend/src/server.js"
click node_messages "https://github.com/crkr-dev/mern-k8s-demo/blob/main/backend/src/server.js"
click node_compose "https://github.com/crkr-dev/mern-k8s-demo/blob/main/docker-compose.yml"
click node_manifests "https://github.com/crkr-dev/mern-k8s-demo/tree/main/k8s"
click node_helm "https://github.com/crkr-dev/mern-k8s-demo/tree/main/helm/mern-k8s-demo"
click node_image_workflow "https://github.com/crkr-dev/mern-k8s-demo/blob/main/.github/workflows/build-and-push.yml"
click node_local_deploy_workflow "https://github.com/crkr-dev/mern-k8s-demo/blob/main/.github/workflows/deploy-local-docker-desktop.yml"

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_bootstrap,node_page,node_user toneBlue
class node_api,node_messages,node_mongo toneAmber
class node_compose,node_manifests,node_helm toneMint
class node_image_workflow,node_local_deploy_workflow,node_ghcr toneRose
```

## Components

### Message app

- [React bootstrap](https://github.com/crkr-dev/mern-k8s-demo/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Message page](https://github.com/crkr-dev/mern-k8s-demo/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`

### API and storage

- [Express API](https://github.com/crkr-dev/mern-k8s-demo/blob/main/backend/src/server.js): `backend/src/server.js`
- [Message persistence](https://github.com/crkr-dev/mern-k8s-demo/blob/main/backend/src/server.js): `backend/src/server.js`
- **MongoDB**

### Deployment options

- [Compose setup](https://github.com/crkr-dev/mern-k8s-demo/blob/main/docker-compose.yml): `docker-compose.yml`
- [Kubernetes manifests](https://github.com/crkr-dev/mern-k8s-demo/tree/main/k8s): `k8s`
- [Helm chart](https://github.com/crkr-dev/mern-k8s-demo/tree/main/helm/mern-k8s-demo): `helm/mern-k8s-demo`

### Image automation

- [Image workflow](https://github.com/crkr-dev/mern-k8s-demo/blob/main/.github/workflows/build-and-push.yml): `.github/workflows/build-and-push.yml`
- [Local deploy workflow](https://github.com/crkr-dev/mern-k8s-demo/blob/main/.github/workflows/deploy-local-docker-desktop.yml): `.github/workflows/deploy-local-docker-desktop.yml`
- **GitHub Container Registry**

### Other components

- **Page user**

## Connections

- Page user → Message page: uses (evidence: `README.md`)
- React bootstrap → Message page: renders (evidence: `frontend/src/main.jsx`)
- Message page → Express API: requests message (evidence: `frontend/src/App.jsx`)
- Express API → Message persistence: reads or creates (evidence: `backend/src/server.js`)
- Message persistence → MongoDB: persists messages (evidence: `backend/src/server.js`)
- Compose setup → Message page: runs app locally (evidence: `README.md`)
- Compose setup → Express API: runs app locally (evidence: `README.md`)
- Compose setup → MongoDB: runs app locally (evidence: `README.md`)
- Kubernetes manifests → Message page: deploys app (evidence: `README.md`)
- Kubernetes manifests → Express API: deploys app (evidence: `README.md`)
- Kubernetes manifests → MongoDB: deploys app (evidence: `README.md`)
- Helm chart → Message page: deploys app (evidence: `README.md`)
- Helm chart → Express API: deploys app (evidence: `README.md`)
- Helm chart → MongoDB: deploys app (evidence: `README.md`)
- Image workflow → GitHub Container Registry: publishes images (evidence: `README.md`)
- Image workflow → Helm chart: deploys images (evidence: `README.md`)
- Local deploy workflow → Helm chart: runs deployment (evidence: `README.md`)
