# amlanpatnaik001/amlanx-qgis-plugin-repository architecture

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

- Interactive diagram: https://gitdiagram.com/amlanpatnaik001/amlanx-qgis-plugin-repository
- Repository: https://github.com/amlanpatnaik001/amlanx-qgis-plugin-repository

## Overview

AMLAN-X is a static catalogue for distributing versioned QGIS plugins. Users find and download plugins through the web catalogue, or add the XML feed to QGIS Plugin Manager to install plugins and check for updates. The build script validates plugin ZIP metadata, selects the latest valid version per plugin, and generates both catalogue formats. The README documents these capabilities and links; generated outputs are not present in the supplied tree, and the web page implementation was not sampled, so those details are shown only at the documented level.

Main entry points: [`scripts/build_repository.py`](https://github.com/amlanpatnaik001/amlanx-qgis-plugin-repository/blob/main/scripts/build_repository.py) (Catalogue builder), [`index.html`](https://github.com/amlanpatnaik001/amlanx-qgis-plugin-repository/blob/main/index.html) (Web catalogue), [`plugins`](https://github.com/amlanpatnaik001/amlanx-qgis-plugin-repository/tree/main/plugins) (Versioned plugin ZIPs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalogue["Plugin catalogue"]
  node_web["Web catalogue<br/>[index.html]"]
  node_qgis["QGIS Plugin Manager"]
  node_feed["QGIS XML feed"]
  node_webdata["Web catalogue data"]
end

subgraph group_generation["Catalogue generation"]
  node_builder["Catalogue builder"]
end

subgraph group_packages["Plugin packages"]
  node_archives[("Versioned plugin ZIPs")]
end

node_user(("Plugin user"))

node_user -->|"searches"| node_web
node_web -->|"offers downloads"| node_user
node_user -->|"installs via"| node_qgis
node_qgis -->|"reads feed"| node_feed
node_qgis -->|"installs packages"| node_archives
node_builder -->|"validates metadata"| node_archives
node_builder -->|"generates"| node_feed
node_builder -->|"generates"| node_webdata
node_web -.->|"uses catalogue data"| node_webdata

click node_web "https://github.com/amlanpatnaik001/amlanx-qgis-plugin-repository/blob/main/index.html"
click node_builder "https://github.com/amlanpatnaik001/amlanx-qgis-plugin-repository/blob/main/scripts/build_repository.py"
click node_archives "https://github.com/amlanpatnaik001/amlanx-qgis-plugin-repository/tree/main/plugins"

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_web,node_qgis,node_feed,node_webdata,node_user toneBlue
class node_builder toneAmber
class node_archives toneMint
```

## Components

### Plugin catalogue

- [Web catalogue](https://github.com/amlanpatnaik001/amlanx-qgis-plugin-repository/blob/main/index.html): `index.html`
- **QGIS Plugin Manager**
- **QGIS XML feed**
- **Web catalogue data**

### Catalogue generation

- [Catalogue builder](https://github.com/amlanpatnaik001/amlanx-qgis-plugin-repository/blob/main/scripts/build_repository.py): `scripts/build_repository.py`

### Plugin packages

- [Versioned plugin ZIPs](https://github.com/amlanpatnaik001/amlanx-qgis-plugin-repository/tree/main/plugins): `plugins`

### Other components

- **Plugin user**

## Connections

- Plugin user → Web catalogue: searches (evidence: `README.md`)
- Web catalogue → Plugin user: offers downloads (evidence: `README.md`)
- Plugin user → QGIS Plugin Manager: installs via (evidence: `README.md`)
- QGIS Plugin Manager → QGIS XML feed: reads feed (evidence: `README.md`)
- QGIS Plugin Manager → Versioned plugin ZIPs: installs packages (evidence: `README.md`)
- Catalogue builder → Versioned plugin ZIPs: validates metadata (evidence: `scripts/build_repository.py`)
- Catalogue builder → QGIS XML feed: generates (evidence: `scripts/build_repository.py`)
- Catalogue builder → Web catalogue data: generates (evidence: `scripts/build_repository.py`)
- Web catalogue → Web catalogue data: uses catalogue data
