# htr-tech/zphisher architecture

> Architecture diagram of the GitHub repository htr-tech/zphisher, 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/htr-tech/zphisher
- Repository: https://github.com/htr-tech/zphisher

## Overview

Zphisher is a Bash-driven phishing demonstration tool with many branded login-page templates and documented tunnel and masked-URL options. The documented operator workflow begins by running the launcher; the template directory and README establish the product’s major capabilities, but no source excerpts were provided to verify internal dispatch, form handling, or data storage. The map therefore omits those uncertain links and does not represent credential handling.

Main entry points: [`zphisher.sh`](https://github.com/htr-tech/zphisher/blob/master/zphisher.sh) (CLI launcher), [`.sites`](https://github.com/htr-tech/zphisher/tree/master/.sites) (Login templates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Operator entry"]
  node_launcher["CLI launcher<br/>[zphisher.sh]"]
end

subgraph group_templates["Page templates"]
  node_page_sets["Login templates<br/>[.sites]"]
  node_brand_pages["Brand pages<br/>[.sites]"]
end

subgraph group_reachability["Link exposure"]
  node_tunnel_modes["Tunnel options<br/>[zphisher.sh]"]
  node_localhost["Localhost"]
  node_cloudflared["Cloudflared"]
  node_localxpose["LocalXpose"]
  node_mask_url["Masked URLs<br/>[zphisher.sh]"]
end

node_operator(("Operator"))
node_visitor(("Page visitor"))

node_operator -->|"runs"| node_launcher
node_launcher -->|"offers templates"| node_page_sets
node_page_sets -->|"includes"| node_brand_pages
node_launcher -->|"offers tunnels"| node_tunnel_modes
node_tunnel_modes -->|"supports"| node_localhost
node_tunnel_modes -.->|"supports"| node_cloudflared
node_tunnel_modes -.->|"supports"| node_localxpose
node_launcher -->|"supports"| node_mask_url
node_visitor -->|"views"| node_brand_pages

click node_launcher "https://github.com/htr-tech/zphisher/blob/master/zphisher.sh"
click node_page_sets "https://github.com/htr-tech/zphisher/tree/master/.sites"
click node_brand_pages "https://github.com/htr-tech/zphisher/tree/master/.sites"
click node_tunnel_modes "https://github.com/htr-tech/zphisher/blob/master/zphisher.sh"
click node_mask_url "https://github.com/htr-tech/zphisher/blob/master/zphisher.sh"

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_launcher toneBlue
class node_page_sets,node_brand_pages toneAmber
class node_tunnel_modes,node_localhost,node_cloudflared,node_localxpose,node_mask_url toneMint
class node_operator,node_visitor toneIndigo
```

## Components

### Operator entry

- [CLI launcher](https://github.com/htr-tech/zphisher/blob/master/zphisher.sh): `zphisher.sh`

### Page templates

- [Login templates](https://github.com/htr-tech/zphisher/tree/master/.sites): `.sites`
- [Brand pages](https://github.com/htr-tech/zphisher/tree/master/.sites): `.sites`

### Link exposure

- [Tunnel options](https://github.com/htr-tech/zphisher/blob/master/zphisher.sh): `zphisher.sh`
- **Localhost**
- **Cloudflared**
- **LocalXpose**
- [Masked URLs](https://github.com/htr-tech/zphisher/blob/master/zphisher.sh): `zphisher.sh`

### Other components

- **Operator**
- **Page visitor**

## Connections

- Operator → CLI launcher: runs
- CLI launcher → Login templates: offers templates
- Login templates → Brand pages: includes
- CLI launcher → Tunnel options: offers tunnels
- Tunnel options → Localhost: supports
- Tunnel options → Cloudflared: supports
- Tunnel options → LocalXpose: supports
- CLI launcher → Masked URLs: supports
- Page visitor → Brand pages: views
