# mizcausevic-dev/kinetic-gain-suite-landing architecture

> Architecture diagram of the GitHub repository mizcausevic-dev/kinetic-gain-suite-landing, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mizcausevic-dev/kinetic-gain-suite-landing
- Repository: https://github.com/mizcausevic-dev/kinetic-gain-suite-landing

## Overview

#### Purpose and principal workflow

This repository is the static public front door for the Kinetic Gain Protocol Suite, linking visitors to its governance-spec descriptions and sibling repositories. A visitor’s browser requests the published pages from the hosting site; maintainers can also run the Node generator to update the vertical hub and eligible vertical pages. Separately, a push to `main` triggers the documented GitHub Actions deployment workflow, which FTP-syncs the site to Hostinger.

#### Components

##### Public pages
- **Suite landing page** — `index.html`: the primary suite entry page; the README identifies it as the landing page.
- **Vertical directory** — `verticals/index.html`: presents the vertical categories and the suite’s six canonical artifact shapes; the generator renders this page from vertical data.
- **Vertical detail pages** — `verticals/healthtech/index.html`: representative hand-authored detail page; the tree contains detail pages for the other verticals as well. Three vertical pages are explicitly marked in the generator as hand-maintained.
- **MCP page** — `mcp/index.html`: a separate static page in the public site; its behavior and relationship to the suite are not established by the sampled source.
- **Site styling** — `style.css`: shared styles for the main site. `verticals/vertical.css` supplies styles for vertical pages, including the dark theme and cards shown in the generator excerpt.

##### Vertical-page authoring
- **Vertical content data** — `verticals/_verticals-data.json`: data consumed by the generator for vertical pages and directory cards.
- **Vertical page generator** — `verticals/_generate.mjs`: when run manually with Node, renders the directory, shared vertical CSS, and data-driven detail pages; it skips the three hand-maintained pages. It links repo cards to GitHub and escapes dynamic text for HTML output.

##### Publishing
- **Deployment workflow** — `.github/workflows/deploy.yml`: the README documents a push-to-`main` workflow that FTP-syncs the site root to `/suite/` on Hostinger.

##### External participants
- **Site visitor** — null repository path: requests and reads the published static pages.
- **GitHub Actions push trigger** — null repository path: an external platform event that starts the documented deployment workflow.
- **Hostinger site hosting** — null repository path: the documented destination for the FTP deployment.
- **Sibling spec repositories** — null repository path: external GitHub repositories linked from vertical content.

#### Relationships

- **Site visitor -> Suite landing page**: requests the published entry page in a browser.
- **Site visitor -> Vertical directory**: requests the directory page to browse the vertical offerings.
- **Site visitor -> Vertical detail pages**: follows directory links to vertical-specific information.
- **Site visitor -> MCP page**: can request this separate page; its purpose is not established by the sampled inputs.
- **Vertical content data -> Vertical page generator**: supplies the vertical records used to render pages and directory cards; evidenced by the JSON read and `data.verticals` mapping.
- **Vertical page generator -> Vertical directory**: writes the rendered directory HTML.
- **Vertical page generator -> Vertical detail pages**: writes pages for eligible verticals and skips the hand-maintained entries.
- **Vertical page generator -> Site styling**: writes the vertical stylesheet.
- **Vertical detail pages -> Sibling spec repositories**: generated repo cards link to GitHub repositories named by the vertical data.
- **GitHub Actions push trigger -> Deployment workflow**: a push to `main` starts the documented workflow.
- **Deployment workflow -> Hostinger site hosting**: FTP-syncs the site root to `/suite/`.

#### Coverage limits

The deployment workflow source, page contents beyond the excerpts, vertical data, and most CSS were not sampled. Deployment details and the no-build-step claim come from the README; runtime behavior of the MCP page and the exact links and content in the hand-maintained pages could not be verified.

Main entry points: [`verticals/_generate.mjs`](https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/verticals/_generate.mjs) (Vertical page generator), [`verticals/healthtech/index.html`](https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/verticals/healthtech/index.html) (Vertical detail pages), [`.github/workflows/deploy.yml`](https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/.github/workflows/deploy.yml) (Deployment workflow), [`verticals/index.html`](https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/verticals/index.html) (Vertical directory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public Pages"]
  node_visitor(("Site visitor<br/>External actor"))
  node_landing["Suite landing page<br/>Static page"]
  node_directory["Vertical directory<br/>Static page"]
  node_details["Vertical detail pages<br/>Static pages"]
  node_mcp["MCP page<br/>Static page"]
  node_sibling_repos["Sibling spec repositories<br/>External repositories"]
end

subgraph group_authoring["Vertical Authoring"]
  node_vertical_data["Vertical content data<br/>JSON data"]
  node_generator["Vertical page generator<br/>Node generator"]
  node_vertical_css["Vertical styling<br/>Stylesheet"]
end

subgraph group_publishing["Publishing"]
  node_trigger(("GitHub Actions push trigger<br/>External event"))
  node_workflow["Deployment workflow<br/>GitHub Actions workflow"]
  node_hosting["Hostinger site hosting<br/>External hosting"]
end

node_visitor -->|"requests"| node_landing
node_visitor -->|"requests"| node_directory
node_visitor -->|"follows links"| node_details
node_visitor -->|"requests"| node_mcp
node_vertical_data -->|"supplies records"| node_generator
node_generator -->|"writes"| node_directory
node_generator -->|"writes eligible pages"| node_details
node_generator -->|"writes"| node_vertical_css
node_details -->|"links to"| node_sibling_repos
node_trigger -->|"starts"| node_workflow
node_workflow -->|"FTP-syncs"| node_hosting

click node_landing "https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/index.html"
click node_directory "https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/verticals/index.html"
click node_details "https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/verticals/healthtech/index.html"
click node_mcp "https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/mcp/index.html"
click node_vertical_data "https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/verticals/_verticals-data.json"
click node_generator "https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/verticals/_generate.mjs"
click node_vertical_css "https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/verticals/vertical.css"
click node_workflow "https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/.github/workflows/deploy.yml"

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_visitor,node_landing,node_directory,node_details,node_mcp,node_sibling_repos toneBlue
class node_vertical_data,node_generator,node_vertical_css toneAmber
class node_trigger,node_workflow,node_hosting toneMint
```

## Components

### Public Pages

- **Site visitor**: External actor
- [Suite landing page](https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/index.html): Static page · `index.html`
- [Vertical directory](https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/verticals/index.html): Static page · `verticals/index.html`
- [Vertical detail pages](https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/verticals/healthtech/index.html): Static pages · `verticals/healthtech/index.html`
- [MCP page](https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/mcp/index.html): Static page · `mcp/index.html`
- **Sibling spec repositories**: External repositories

### Vertical Authoring

- [Vertical content data](https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/verticals/_verticals-data.json): JSON data · `verticals/_verticals-data.json`
- [Vertical page generator](https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/verticals/_generate.mjs): Node generator · Skips the three hand-maintained vertical pages. · `verticals/_generate.mjs`
- [Vertical styling](https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/verticals/vertical.css): Stylesheet · `verticals/vertical.css`

### Publishing

- **GitHub Actions push trigger**: External event
- [Deployment workflow](https://github.com/mizcausevic-dev/kinetic-gain-suite-landing/blob/main/.github/workflows/deploy.yml): GitHub Actions workflow · `.github/workflows/deploy.yml`
- **Hostinger site hosting**: External hosting

## Connections

- Site visitor → Suite landing page: requests
- Site visitor → Vertical directory: requests
- Site visitor → Vertical detail pages: follows links
- Site visitor → MCP page: requests
- Vertical content data → Vertical page generator: supplies records
- Vertical page generator → Vertical directory: writes
- Vertical page generator → Vertical detail pages: writes eligible pages
- Vertical page generator → Vertical styling: writes
- Vertical detail pages → Sibling spec repositories: links to
- GitHub Actions push trigger → Deployment workflow: starts · Push to main triggers the workflow.
- Deployment workflow → Hostinger site hosting: FTP-syncs · Syncs the site root to /suite/.