# gorgasal22-lgtm/kginfluencex architecture

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

- Interactive diagram: https://gitdiagram.com/gorgasal22-lgtm/kginfluencex
- Repository: https://github.com/gorgasal22-lgtm/kginfluencex

## Overview

KGinfluenceX is primarily a React SPA for connecting Georgian brands and influencers. Users enter through login, then navigate to dashboard, influencer, campaign, analytics, brand, content, settings, academy, and AI-studio areas. The SPA uses Supabase for authentication and data access; a separate Express service currently exposes an API router with a health route. The excerpts establish routing and login authentication, but do not show the implementation details of most feature pages or a connection between the SPA and the Express service.

Main entry points: [`artifacts/kginfluencex/src/App.tsx`](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/App.tsx) (App routes), [`artifacts/kginfluencex/src/pages/LoginPage.tsx`](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/LoginPage.tsx) (Login and signup), [`artifacts/api-server/src/app.ts`](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/api-server/src/app.ts) (Express app), [`artifacts/api-server/src/routes/index.ts`](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/api-server/src/routes/index.ts) (API router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_spa["SPA shell"]
  node_entry["React entry<br/>[main.tsx]"]
  node_router["App routes<br/>[App.tsx]"]
end

subgraph group_account["Account access"]
  node_login["Login and signup<br/>[LoginPage.tsx]"]
  node_supabase[("Supabase auth and data<br/>[supabase.ts]")]
end

subgraph group_market["Marketplace workflows"]
  node_dashboard["Dashboard<br/>[DashboardPage.tsx]"]
  node_influencers["Influencers"]
  node_campaigns["Campaigns<br/>[CampaignsPage.tsx]"]
  node_brands["Brands<br/>[BrandsPage.tsx]"]
  node_content["Content<br/>[ContentPage.tsx]"]
end

subgraph group_insights["Insights and tools"]
  node_analytics["Analytics<br/>[AnalyticsPage.tsx]"]
  node_academy["Academy<br/>[AcademyPage.tsx]"]
  node_ai["AI studio<br/>[AiStudioPage.tsx]"]
  node_settings["Settings<br/>[SettingsPage.tsx]"]
end

subgraph group_server["API service"]
  node_api["Express app<br/>[app.ts]"]
  node_logger["HTTP logger<br/>[logger.ts]"]
  node_api_routes["API router<br/>[index.ts]"]
  node_health["Health route<br/>[health.ts]"]
end

node_user(("Platform user"))

node_entry -->|"renders"| node_router
node_user -->|"authenticates"| node_login
node_router -->|"routes to"| node_login
node_router -->|"routes to"| node_dashboard
node_router -->|"routes to"| node_influencers
node_router -->|"routes to"| node_campaigns
node_router -->|"routes to"| node_analytics
node_router -->|"routes to"| node_brands
node_router -->|"routes to"| node_content
node_router -->|"routes to"| node_settings
node_router -->|"routes to"| node_academy
node_router -->|"routes to"| node_ai
node_login -->|"authenticates with"| node_supabase
node_api -->|"configures"| node_logger
node_api -->|"mounts"| node_api_routes
node_api_routes -->|"registers"| node_health

click node_entry "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/main.tsx"
click node_router "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/App.tsx"
click node_login "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/LoginPage.tsx"
click node_supabase "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/lib/supabase.ts"
click node_dashboard "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/DashboardPage.tsx"
click node_influencers "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/InfluencersPage.tsx"
click node_campaigns "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/CampaignsPage.tsx"
click node_brands "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/BrandsPage.tsx"
click node_content "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/ContentPage.tsx"
click node_analytics "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/AnalyticsPage.tsx"
click node_academy "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/AcademyPage.tsx"
click node_ai "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/AiStudioPage.tsx"
click node_settings "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/SettingsPage.tsx"
click node_api "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/api-server/src/app.ts"
click node_logger "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/api-server/src/lib/logger.ts"
click node_api_routes "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/api-server/src/routes/index.ts"
click node_health "https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/api-server/src/routes/health.ts"

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_entry,node_router,node_user toneBlue
class node_login,node_supabase toneAmber
class node_dashboard,node_influencers,node_campaigns,node_brands,node_content toneMint
class node_analytics,node_academy,node_ai,node_settings toneRose
class node_api,node_logger,node_api_routes,node_health toneIndigo
```

## Components

### SPA shell

- [React entry](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/main.tsx): `artifacts/kginfluencex/src/main.tsx`
- [App routes](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/App.tsx): `artifacts/kginfluencex/src/App.tsx`

### Account access

- [Login and signup](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/LoginPage.tsx): `artifacts/kginfluencex/src/pages/LoginPage.tsx`
- [Supabase auth and data](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/lib/supabase.ts): `artifacts/kginfluencex/src/lib/supabase.ts`

### Marketplace workflows

- [Dashboard](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/DashboardPage.tsx): `artifacts/kginfluencex/src/pages/DashboardPage.tsx`
- [Influencers](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/InfluencersPage.tsx): `artifacts/kginfluencex/src/pages/InfluencersPage.tsx`
- [Campaigns](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/CampaignsPage.tsx): `artifacts/kginfluencex/src/pages/CampaignsPage.tsx`
- [Brands](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/BrandsPage.tsx): `artifacts/kginfluencex/src/pages/BrandsPage.tsx`
- [Content](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/ContentPage.tsx): `artifacts/kginfluencex/src/pages/ContentPage.tsx`

### Insights and tools

- [Analytics](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/AnalyticsPage.tsx): `artifacts/kginfluencex/src/pages/AnalyticsPage.tsx`
- [Academy](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/AcademyPage.tsx): `artifacts/kginfluencex/src/pages/AcademyPage.tsx`
- [AI studio](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/AiStudioPage.tsx): `artifacts/kginfluencex/src/pages/AiStudioPage.tsx`
- [Settings](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/kginfluencex/src/pages/SettingsPage.tsx): `artifacts/kginfluencex/src/pages/SettingsPage.tsx`

### API service

- [Express app](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/api-server/src/app.ts): `artifacts/api-server/src/app.ts`
- [HTTP logger](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/api-server/src/lib/logger.ts): `artifacts/api-server/src/lib/logger.ts`
- [API router](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/api-server/src/routes/index.ts): `artifacts/api-server/src/routes/index.ts`
- [Health route](https://github.com/gorgasal22-lgtm/kginfluencex/blob/main/artifacts/api-server/src/routes/health.ts): `artifacts/api-server/src/routes/health.ts`

### Other components

- **Platform user**

## Connections

- React entry → App routes: renders (evidence: `artifacts/kginfluencex/src/main.tsx`)
- Platform user → Login and signup: authenticates (evidence: `artifacts/kginfluencex/src/pages/LoginPage.tsx`)
- App routes → Login and signup: routes to (evidence: `artifacts/kginfluencex/src/App.tsx`)
- App routes → Dashboard: routes to (evidence: `artifacts/kginfluencex/src/App.tsx`)
- App routes → Influencers: routes to (evidence: `artifacts/kginfluencex/src/App.tsx`)
- App routes → Campaigns: routes to (evidence: `artifacts/kginfluencex/src/App.tsx`)
- App routes → Analytics: routes to (evidence: `artifacts/kginfluencex/src/App.tsx`)
- App routes → Brands: routes to (evidence: `artifacts/kginfluencex/src/App.tsx`)
- App routes → Content: routes to (evidence: `artifacts/kginfluencex/src/App.tsx`)
- App routes → Settings: routes to (evidence: `artifacts/kginfluencex/src/App.tsx`)
- App routes → Academy: routes to (evidence: `artifacts/kginfluencex/src/App.tsx`)
- App routes → AI studio: routes to (evidence: `artifacts/kginfluencex/src/App.tsx`)
- Login and signup → Supabase auth and data: authenticates with (evidence: `artifacts/kginfluencex/src/pages/LoginPage.tsx`)
- Express app → HTTP logger: configures (evidence: `artifacts/api-server/src/app.ts`)
- Express app → API router: mounts (evidence: `artifacts/api-server/src/app.ts`)
- API router → Health route: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
