# vx2-sagar-codes/.mdarmor-repo architecture

> Architecture diagram of the GitHub repository vx2-sagar-codes/.mdarmor-repo, 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/vx2-sagar-codes/.mdarmor-repo
- Repository: https://github.com/vx2-sagar-codes/.mdarmor-repo

## Overview

.mdArmor is a small Streamlit app for generating copyable Shields.io badge links. Users choose a style, enter a label, message, and logo, and select a colour; the app normalizes spaces in the label and message, then displays the requirements, Markdown snippet, and a link to view the badge. The runtime is shown in one source file; no separate subsystems are evident.

Main entry points: [`mdArmor.py`](https://github.com/vx2-sagar-codes/.mdarmor-repo/blob/main/mdArmor.py) (Badge generator UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_app["Badge generator UI<br/>[mdArmor.py]"]
node_config["Badge settings<br/>[mdArmor.py]"]
node_output["Markdown and requirements<br/>[mdArmor.py]"]
node_shields["Shields.io"]

node_user -->|"uses"| node_app
node_app -->|"collects settings"| node_config
node_app -->|"renders"| node_output
node_app -->|"links to badge"| node_shields

click node_app "https://github.com/vx2-sagar-codes/.mdarmor-repo/blob/main/mdArmor.py"
click node_config "https://github.com/vx2-sagar-codes/.mdarmor-repo/blob/main/mdArmor.py"
click node_output "https://github.com/vx2-sagar-codes/.mdarmor-repo/blob/main/mdArmor.py"

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_user,node_app toneBlue
class node_config,node_output toneTeal
class node_shields toneIndigo
```

## Components

### Other components

- **User**
- [Badge generator UI](https://github.com/vx2-sagar-codes/.mdarmor-repo/blob/main/mdArmor.py): `mdArmor.py`
- [Badge settings](https://github.com/vx2-sagar-codes/.mdarmor-repo/blob/main/mdArmor.py): `mdArmor.py`
- [Markdown and requirements](https://github.com/vx2-sagar-codes/.mdarmor-repo/blob/main/mdArmor.py): `mdArmor.py`
- **Shields.io**

## Connections

- User → Badge generator UI: uses
- Badge generator UI → Badge settings: collects settings
- Badge generator UI → Markdown and requirements: renders
- Badge generator UI → Shields.io: links to badge