# kksquareinnovations-wq/kk-website architecture

> Architecture diagram of the GitHub repository kksquareinnovations-wq/kk-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kksquareinnovations-wq/kk-website
- Repository: https://github.com/kksquareinnovations-wq/kk-website

## Overview

This repository is a Next.js product portfolio site: visitors browse a landing-page catalog, read individual product pages, and can submit feedback or donate. The contact workflow validates and saves submissions as JSON files; donation forms post to PayPal. Product detail pages describe investment tracking, market alerts, portfolio balance monitoring, and account-expiry tracking, but appear to be informational pages rather than implementations of those products. Source excerpts are partial, so links between unsampled pages and runtime behavior are omitted.

Main entry points: [`src/app/page.tsx`](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/page.tsx) (Catalog Home), [`src/components/ContactForm.tsx`](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/components/ContactForm.tsx) (Contact Form), [`src/app/extensions/investment-tracker-pro/page.tsx`](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/extensions/investment-tracker-pro/page.tsx) (Investment Tracker), [`src/app/api/contact/route.ts`](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/api/contact/route.ts) (Contact API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Portfolio Site"]
  node_home["Catalog Home<br/>[page.tsx]"]
end

subgraph group_products["Product Pages"]
  node_investment["Investment Tracker<br/>[page.tsx]"]
  node_alerts["Market Alert System<br/>[page.tsx]"]
  node_balance["Balance Monitor<br/>[page.tsx]"]
  node_expiry["Expiry Tracker<br/>[page.tsx]"]
end

subgraph group_contact["Contact Workflow"]
  node_contactform["Contact Form<br/>[ContactForm.tsx]"]
  node_contactapi["Contact API<br/>[route.ts]"]
  node_submissions[("Submission Files")]
end

subgraph group_ui["Shared UI"]
  node_header["Header<br/>[Header.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_motion["Animation Hooks"]
  node_cardmotion["3D Card Wrapper"]
end

node_visitor(("Visitor"))
node_paypal["PayPal"]

node_visitor -->|"opens"| node_home
node_home -->|"links to"| node_investment
node_home -->|"links to"| node_alerts
node_home -->|"links to"| node_balance
node_home -->|"links to"| node_expiry
node_home -->|"renders"| node_header
node_home -->|"renders"| node_footer
node_home -->|"renders"| node_contactform
node_home -->|"renders"| node_cardmotion
node_home -->|"uses"| node_motion
node_visitor -->|"submits"| node_contactform
node_contactform -->|"posts to"| node_contactapi
node_contactapi -->|"writes"| node_submissions
node_visitor -.->|"donates via"| node_paypal
node_investment -.->|"donates via"| node_paypal

click node_home "https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/page.tsx"
click node_investment "https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/extensions/investment-tracker-pro/page.tsx"
click node_alerts "https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/extensions/market-alert-system/page.tsx"
click node_balance "https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/extensions/portfolio-balance-monitor/page.tsx"
click node_expiry "https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/products/accounts-expiry-tracker/page.tsx"
click node_contactform "https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/components/ContactForm.tsx"
click node_contactapi "https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/api/contact/route.ts"
click node_submissions "https://github.com/kksquareinnovations-wq/kk-website/tree/main/data/contact-submissions"
click node_header "https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/components/Header.tsx"
click node_footer "https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/components/Footer.tsx"
click node_motion "https://github.com/kksquareinnovations-wq/kk-website/tree/main/src/hooks"
click node_cardmotion "https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/components/MouseFollow3DContainer.tsx"

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_home toneBlue
class node_investment,node_alerts,node_balance,node_expiry toneAmber
class node_contactform,node_contactapi,node_submissions toneMint
class node_header,node_footer,node_motion,node_cardmotion toneRose
class node_visitor,node_paypal toneIndigo
```

## Components

### Portfolio Site

- [Catalog Home](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/page.tsx): `src/app/page.tsx`

### Product Pages

- [Investment Tracker](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/extensions/investment-tracker-pro/page.tsx): `src/app/extensions/investment-tracker-pro/page.tsx`
- [Market Alert System](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/extensions/market-alert-system/page.tsx): `src/app/extensions/market-alert-system/page.tsx`
- [Balance Monitor](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/extensions/portfolio-balance-monitor/page.tsx): `src/app/extensions/portfolio-balance-monitor/page.tsx`
- [Expiry Tracker](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/products/accounts-expiry-tracker/page.tsx): `src/app/products/accounts-expiry-tracker/page.tsx`

### Contact Workflow

- [Contact Form](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/components/ContactForm.tsx): `src/components/ContactForm.tsx`
- [Contact API](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/app/api/contact/route.ts): `src/app/api/contact/route.ts`
- [Submission Files](https://github.com/kksquareinnovations-wq/kk-website/tree/main/data/contact-submissions): `data/contact-submissions`

### Shared UI

- [Header](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/components/Header.tsx): `src/components/Header.tsx`
- [Footer](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`
- [Animation Hooks](https://github.com/kksquareinnovations-wq/kk-website/tree/main/src/hooks): `src/hooks`
- [3D Card Wrapper](https://github.com/kksquareinnovations-wq/kk-website/blob/main/src/components/MouseFollow3DContainer.tsx): `src/components/MouseFollow3DContainer.tsx`

### Other components

- **Visitor**
- **PayPal**

## Connections

- Visitor → Catalog Home: opens
- Catalog Home → Investment Tracker: links to
- Catalog Home → Market Alert System: links to
- Catalog Home → Balance Monitor: links to
- Catalog Home → Expiry Tracker: links to
- Catalog Home → Header: renders
- Catalog Home → Footer: renders
- Catalog Home → Contact Form: renders
- Catalog Home → 3D Card Wrapper: renders
- Catalog Home → Animation Hooks: uses
- Visitor → Contact Form: submits
- Contact Form → Contact API: posts to
- Contact API → Submission Files: writes
- Visitor → PayPal: donates via
- Investment Tracker → PayPal: donates via