# dabhix/web-check architecture

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

- Interactive diagram: https://gitdiagram.com/dabhix/web-check
- Repository: https://github.com/dabhix/web-check

## Overview

Web-Check is an on-demand website OSINT dashboard: a user submits a site to inspect and views a collection of infrastructure, security, and content findings. The UI routes between the scan form and results; API handlers normalize requests through shared middleware and perform individual checks. The README documents a broad set of dashboard capabilities, including DNS, certificates, ports, performance, and trackers. Several UI-to-API connections are not visible in the excerpts, so those are omitted rather than inferred.

Main entry points: [`api/_common/middleware.js`](https://github.com/dabhix/web-check/blob/master/api/_common/middleware.js) (Request middleware), [`src/web-check-live/App.tsx`](https://github.com/dabhix/web-check/blob/master/src/web-check-live/App.tsx) (App routing), [`api/threats.js`](https://github.com/dabhix/web-check/blob/master/api/threats.js) (Threat reputation), [`src/web-check-live/views/Home.tsx`](https://github.com/dabhix/web-check/blob/master/src/web-check-live/views/Home.tsx) (Scan form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web interface"]
  node_app["App routing<br/>[App.tsx]"]
  node_home["Scan form<br/>[Home.tsx]"]
  node_results["Results dashboard<br/>[Results.tsx]"]
  node_scan_hook["Scan data hook"]
  node_result_processing["Result processing"]
end

subgraph group_api["Scan API"]
  node_middleware["Request middleware<br/>[middleware.js]"]
end

subgraph group_security["Security checks"]
  node_security_checks["Security checks"]
  node_threat_check["Threat reputation<br/>[threats.js]"]
  node_firewall_check["Firewall detection<br/>[firewall.js]"]
  node_blocklist_check["DNS blocklists<br/>[block-lists.js]"]
  node_external_sources["Threat data services"]
end

subgraph group_intelligence["Site intelligence"]
  node_api_routes["Site data checks"]
  node_domain_checks["Domain intelligence<br/>[whois.js]"]
  node_archive_check["Archive history<br/>[archives.js]"]
  node_screenshot_check["Page screenshot<br/>[screenshot.js]"]
  node_dns_check["DNS checks<br/>[dns.js]"]
  node_network_checks["Network checks<br/>[ports.js]"]
end

node_user(("Site investigator"))

node_user -.->|"submits site"| node_home
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_results
node_api_routes -->|"wraps handlers"| node_middleware
node_domain_checks -->|"wraps handler"| node_middleware
node_archive_check -->|"wraps handler"| node_middleware
node_screenshot_check -->|"wraps handler"| node_middleware
node_dns_check -.->|"wraps handler"| node_middleware
node_network_checks -->|"wraps handler"| node_middleware
node_security_checks -.->|"wraps handlers"| node_middleware
node_threat_check -->|"wraps handler"| node_middleware
node_firewall_check -->|"wraps handler"| node_middleware
node_blocklist_check -->|"wraps handler"| node_middleware
node_threat_check -->|"queries services"| node_external_sources

click node_app "https://github.com/dabhix/web-check/blob/master/src/web-check-live/App.tsx"
click node_home "https://github.com/dabhix/web-check/blob/master/src/web-check-live/views/Home.tsx"
click node_results "https://github.com/dabhix/web-check/blob/master/src/web-check-live/views/Results.tsx"
click node_scan_hook "https://github.com/dabhix/web-check/blob/master/src/web-check-live/hooks/motherOfAllHooks.ts"
click node_result_processing "https://github.com/dabhix/web-check/blob/master/src/web-check-live/utils/result-processor.ts"
click node_middleware "https://github.com/dabhix/web-check/blob/master/api/_common/middleware.js"
click node_api_routes "https://github.com/dabhix/web-check/tree/master/api"
click node_domain_checks "https://github.com/dabhix/web-check/blob/master/api/whois.js"
click node_archive_check "https://github.com/dabhix/web-check/blob/master/api/archives.js"
click node_screenshot_check "https://github.com/dabhix/web-check/blob/master/api/screenshot.js"
click node_dns_check "https://github.com/dabhix/web-check/blob/master/api/dns.js"
click node_network_checks "https://github.com/dabhix/web-check/blob/master/api/ports.js"
click node_security_checks "https://github.com/dabhix/web-check/tree/master/api"
click node_threat_check "https://github.com/dabhix/web-check/blob/master/api/threats.js"
click node_firewall_check "https://github.com/dabhix/web-check/blob/master/api/firewall.js"
click node_blocklist_check "https://github.com/dabhix/web-check/blob/master/api/block-lists.js"

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_app,node_home,node_results,node_scan_hook,node_result_processing toneBlue
class node_middleware toneAmber
class node_security_checks,node_threat_check,node_firewall_check,node_blocklist_check,node_external_sources toneMint
class node_api_routes,node_domain_checks,node_archive_check,node_screenshot_check,node_dns_check,node_network_checks toneRose
class node_user toneIndigo
```

## Components

### Web interface

- [App routing](https://github.com/dabhix/web-check/blob/master/src/web-check-live/App.tsx): `src/web-check-live/App.tsx`
- [Scan form](https://github.com/dabhix/web-check/blob/master/src/web-check-live/views/Home.tsx): `src/web-check-live/views/Home.tsx`
- [Results dashboard](https://github.com/dabhix/web-check/blob/master/src/web-check-live/views/Results.tsx): `src/web-check-live/views/Results.tsx`
- [Scan data hook](https://github.com/dabhix/web-check/blob/master/src/web-check-live/hooks/motherOfAllHooks.ts): `src/web-check-live/hooks/motherOfAllHooks.ts`
- [Result processing](https://github.com/dabhix/web-check/blob/master/src/web-check-live/utils/result-processor.ts): `src/web-check-live/utils/result-processor.ts`

### Scan API

- [Request middleware](https://github.com/dabhix/web-check/blob/master/api/_common/middleware.js): `api/_common/middleware.js`

### Security checks

- [Security checks](https://github.com/dabhix/web-check/tree/master/api): `api`
- [Threat reputation](https://github.com/dabhix/web-check/blob/master/api/threats.js): `api/threats.js`
- [Firewall detection](https://github.com/dabhix/web-check/blob/master/api/firewall.js): `api/firewall.js`
- [DNS blocklists](https://github.com/dabhix/web-check/blob/master/api/block-lists.js): `api/block-lists.js`
- **Threat data services**

### Site intelligence

- [Site data checks](https://github.com/dabhix/web-check/tree/master/api): `api`
- [Domain intelligence](https://github.com/dabhix/web-check/blob/master/api/whois.js): `api/whois.js`
- [Archive history](https://github.com/dabhix/web-check/blob/master/api/archives.js): `api/archives.js`
- [Page screenshot](https://github.com/dabhix/web-check/blob/master/api/screenshot.js): `api/screenshot.js`
- [DNS checks](https://github.com/dabhix/web-check/blob/master/api/dns.js): `api/dns.js`
- [Network checks](https://github.com/dabhix/web-check/blob/master/api/ports.js): `api/ports.js`

### Other components

- **Site investigator**

## Connections

- Site investigator → Scan form: submits site
- App routing → Scan form: routes to (evidence: `src/web-check-live/App.tsx`)
- App routing → Results dashboard: routes to (evidence: `src/web-check-live/App.tsx`)
- Site data checks → Request middleware: wraps handlers (evidence: `api/_common/middleware.js`)
- Domain intelligence → Request middleware: wraps handler (evidence: `api/whois.js`)
- Archive history → Request middleware: wraps handler (evidence: `api/archives.js`)
- Page screenshot → Request middleware: wraps handler (evidence: `api/screenshot.js`)
- DNS checks → Request middleware: wraps handler
- Network checks → Request middleware: wraps handler (evidence: `api/ports.js`)
- Security checks → Request middleware: wraps handlers (evidence: `api/screenshot.js`)
- Threat reputation → Request middleware: wraps handler (evidence: `api/threats.js`)
- Firewall detection → Request middleware: wraps handler (evidence: `api/firewall.js`)
- DNS blocklists → Request middleware: wraps handler (evidence: `api/block-lists.js`)
- Threat reputation → Threat data services: queries services (evidence: `api/threats.js`)
