# opussf/mogshare architecture

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

- Interactive diagram: https://gitdiagram.com/opussf/mogshare
- Repository: https://github.com/opussf/mogshare

## Overview

MogShare is a World of Warcraft addon for capturing and revisiting player appearances, with a separate mog-war voting game. The documented workflow scans a player, captures their Custom Mog link, saves it, then lets the user review and rate it later in the dressing room. The README also describes choosing between two mogs. Source excerpts were not provided, so paths identify likely implementation files from the tree; relationships below are limited to those explicitly documented in the README.

Main entry points: [`src/MogShare.lua`](https://github.com/opussf/mogshare/blob/develop/src/MogShare.lua) (Saved Mogs), [`src/MogShareUI.lua`](https://github.com/opussf/mogshare/blob/develop/src/MogShareUI.lua) (Two Mog Choices)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Appearance Capture"]
  node_scanner["Player Scanner<br/>[MogShare.lua]"]
  node_link["Mog Link Capture<br/>[MogShare.lua]"]
end

subgraph group_review["Saved Mog Review"]
  node_saved[("Saved Mogs<br/>[MogShare.lua]")]
  node_review_ui["Review and Rate<br/>[MogShareUI.lua]"]
end

subgraph group_game["Mog War"]
  node_mog_war["Mog War<br/>[MogShare.lua]"]
  node_mog_choices["Two Mog Choices<br/>[MogShareUI.lua]"]
  node_ui_layout["Addon UI Layout<br/>[MogShare.xml]"]
end

node_player(("Player"))
node_dressing_room["Dressing Room"]

node_player -->|"is scanned"| node_scanner
node_scanner -->|"captures link"| node_link
node_link -->|"saves link"| node_saved
node_saved -->|"reviewed and rated"| node_review_ui
node_saved -->|"viewed later in"| node_dressing_room
node_mog_war -->|"shows two mogs"| node_mog_choices
node_player -->|"picks favorite"| node_mog_choices

click node_scanner "https://github.com/opussf/mogshare/blob/develop/src/MogShare.lua"
click node_link "https://github.com/opussf/mogshare/blob/develop/src/MogShare.lua"
click node_saved "https://github.com/opussf/mogshare/blob/develop/src/MogShare.lua"
click node_review_ui "https://github.com/opussf/mogshare/blob/develop/src/MogShareUI.lua"
click node_mog_war "https://github.com/opussf/mogshare/blob/develop/src/MogShare.lua"
click node_mog_choices "https://github.com/opussf/mogshare/blob/develop/src/MogShareUI.lua"
click node_ui_layout "https://github.com/opussf/mogshare/blob/develop/src/MogShare.xml"

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_scanner,node_link toneBlue
class node_saved,node_review_ui toneAmber
class node_mog_war,node_mog_choices,node_ui_layout toneMint
class node_player,node_dressing_room toneIndigo
```

## Components

### Appearance Capture

- [Player Scanner](https://github.com/opussf/mogshare/blob/develop/src/MogShare.lua): `src/MogShare.lua`
- [Mog Link Capture](https://github.com/opussf/mogshare/blob/develop/src/MogShare.lua): `src/MogShare.lua`

### Saved Mog Review

- [Saved Mogs](https://github.com/opussf/mogshare/blob/develop/src/MogShare.lua): `src/MogShare.lua`
- [Review and Rate](https://github.com/opussf/mogshare/blob/develop/src/MogShareUI.lua): `src/MogShareUI.lua`

### Mog War

- [Mog War](https://github.com/opussf/mogshare/blob/develop/src/MogShare.lua): `src/MogShare.lua`
- [Two Mog Choices](https://github.com/opussf/mogshare/blob/develop/src/MogShareUI.lua): `src/MogShareUI.lua`
- [Addon UI Layout](https://github.com/opussf/mogshare/blob/develop/src/MogShare.xml): `src/MogShare.xml`

### Other components

- **Player**
- **Dressing Room**

## Connections

- Player → Player Scanner: is scanned (evidence: `README.md`)
- Player Scanner → Mog Link Capture: captures link (evidence: `README.md`)
- Mog Link Capture → Saved Mogs: saves link (evidence: `README.md`)
- Saved Mogs → Review and Rate: reviewed and rated (evidence: `README.md`)
- Saved Mogs → Dressing Room: viewed later in (evidence: `README.md`)
- Mog War → Two Mog Choices: shows two mogs (evidence: `README.md`)
- Player → Two Mog Choices: picks favorite (evidence: `README.md`)
