# lv2402/vjsv architecture

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

- Interactive diagram: https://gitdiagram.com/lv2402/vjsv
- Repository: https://github.com/lv2402/vjsv

## Overview

VJSV Sahithi Vanam is a Telugu literary and cultural organization website. Visitors enter through routed pages to explore the organization, Akshara, event histories, gallery, and creative writing; the event and writing experiences can also use admin-managed content. An admin page manages that content through a shared API helper. The source excerpts show the frontend routes and several API calls, but not the backend implementation’s relationship to those requests, so that connection is left unasserted.

Main entry points: [`src/App.tsx`](https://github.com/lv2402/vjsv/blob/main/src/App.tsx) (Route application), [`src/lib/adminApi.ts`](https://github.com/lv2402/vjsv/blob/main/src/lib/adminApi.ts) (Admin API client), [`src/pages/Index.tsx`](https://github.com/lv2402/vjsv/blob/main/src/pages/Index.tsx) (Home page), [`src/pages/Gallery.tsx`](https://github.com/lv2402/vjsv/blob/main/src/pages/Gallery.tsx) (Gallery page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Site experience"]
  node_app["Route application<br/>[App.tsx]"]
  node_home["Home page<br/>[Index.tsx]"]
  node_navigation["Site navigation<br/>[Navbar.tsx]"]
  node_hero["Home hero<br/>[Hero.tsx]"]
  node_boxes["Feature boxes<br/>[Boxes.tsx]"]
  node_highlights["Recent highlights"]
  node_footer["Site footer<br/>[Footer.tsx]"]
  node_bootstrap["Frontend entry<br/>[main.tsx]"]
end

subgraph group_content["Cultural content"]
  node_akshara["Akshara page<br/>[Akshara.tsx]"]
  node_events["Events index<br/>[Events.tsx]"]
  node_convergence["Convergence<br/>[Convergence.tsx]"]
  node_sintillashunz["Sintillashunz<br/>[Sintillashunz.tsx]"]
  node_workshops["Workshops<br/>[Workshops.tsx]"]
  node_blogs["Creative writing<br/>[Blogs.tsx]"]
  node_gallery["Gallery page<br/>[Gallery.tsx]"]
  node_gallerygrid["Gallery grid<br/>[GalleryGrid.tsx]"]
  node_aksharadata["Akshara event data<br/>[aksharaEvents.ts]"]
  node_convergencedata["Convergence event data"]
  node_sintidata["Sintillashunz event data"]
  node_workshopdata["Workshop event data<br/>[workshopsEvents.ts]"]
  node_highlightdata["Highlight data<br/>[highlights.ts]"]
  node_gallerydata["Gallery image data<br/>[galleryImages.ts]"]
end

subgraph group_admin["Content management"]
  node_adminpage["Admin console<br/>[Admin.tsx]"]
  node_backend["Backend service<br/>[main.py]"]
end

subgraph group_shared["Shared services"]
  node_adminapi["Admin API client<br/>[adminApi.ts]"]
end

node_visitor(("Visitor"))
node_api(("HTTP API"))

node_visitor -->|"opens"| node_app
node_bootstrap -->|"mounts"| node_app
node_app -->|"routes"| node_home
node_app -->|"routes"| node_akshara
node_app -->|"routes"| node_convergence
node_app -->|"routes"| node_sintillashunz
node_app -->|"routes"| node_workshops
node_app -->|"routes"| node_gallery
node_app -->|"routes"| node_blogs
node_app -->|"routes"| node_adminpage
node_home -->|"renders"| node_navigation
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_boxes
node_home -->|"renders"| node_highlights
node_home -->|"renders"| node_footer
node_gallery -->|"renders"| node_navigation
node_gallery -->|"renders"| node_gallerygrid
node_gallery -->|"renders"| node_footer
node_highlights -->|"fetches"| node_adminapi
node_akshara -.->|"fetches"| node_adminapi
node_convergence -->|"fetches"| node_adminapi
node_sintillashunz -->|"fetches"| node_adminapi
node_workshops -->|"fetches"| node_adminapi
node_blogs -.->|"fetches"| node_adminapi
node_adminpage -.->|"manages content"| node_adminapi
node_adminapi -->|"sends requests"| node_api
node_akshara -.->|"reads"| node_aksharadata
node_convergence -.->|"reads"| node_convergencedata
node_sintillashunz -.->|"reads"| node_sintidata
node_workshops -.->|"reads"| node_workshopdata
node_highlights -.->|"reads"| node_highlightdata
node_gallerygrid -.->|"reads"| node_gallerydata

click node_app "https://github.com/lv2402/vjsv/blob/main/src/App.tsx"
click node_home "https://github.com/lv2402/vjsv/blob/main/src/pages/Index.tsx"
click node_navigation "https://github.com/lv2402/vjsv/blob/main/src/components/Navbar.tsx"
click node_hero "https://github.com/lv2402/vjsv/blob/main/src/components/Hero.tsx"
click node_boxes "https://github.com/lv2402/vjsv/blob/main/src/components/Boxes.tsx"
click node_highlights "https://github.com/lv2402/vjsv/blob/main/src/components/RecentHighlights.tsx"
click node_footer "https://github.com/lv2402/vjsv/blob/main/src/components/Footer.tsx"
click node_akshara "https://github.com/lv2402/vjsv/blob/main/src/pages/Akshara.tsx"
click node_events "https://github.com/lv2402/vjsv/blob/main/src/pages/Events.tsx"
click node_convergence "https://github.com/lv2402/vjsv/blob/main/src/pages/Events/Convergence/Convergence.tsx"
click node_sintillashunz "https://github.com/lv2402/vjsv/blob/main/src/pages/Events/Sintillashunz/Sintillashunz.tsx"
click node_workshops "https://github.com/lv2402/vjsv/blob/main/src/pages/Events/Workshops/Workshops.tsx"
click node_blogs "https://github.com/lv2402/vjsv/blob/main/src/pages/Blogs.tsx"
click node_gallery "https://github.com/lv2402/vjsv/blob/main/src/pages/Gallery.tsx"
click node_gallerygrid "https://github.com/lv2402/vjsv/blob/main/src/components/GalleryGrid.tsx"
click node_adminpage "https://github.com/lv2402/vjsv/blob/main/src/pages/Admin.tsx"
click node_adminapi "https://github.com/lv2402/vjsv/blob/main/src/lib/adminApi.ts"
click node_backend "https://github.com/lv2402/vjsv/blob/main/server/main.py"
click node_aksharadata "https://github.com/lv2402/vjsv/blob/main/src/lib/aksharaEvents.ts"
click node_convergencedata "https://github.com/lv2402/vjsv/blob/main/src/lib/convergenceEvents.ts"
click node_sintidata "https://github.com/lv2402/vjsv/blob/main/src/lib/sintillashunzEvents.ts"
click node_workshopdata "https://github.com/lv2402/vjsv/blob/main/src/lib/workshopsEvents.ts"
click node_highlightdata "https://github.com/lv2402/vjsv/blob/main/src/lib/highlights.ts"
click node_gallerydata "https://github.com/lv2402/vjsv/blob/main/src/lib/galleryImages.ts"
click node_bootstrap "https://github.com/lv2402/vjsv/blob/main/src/main.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_app,node_home,node_navigation,node_hero,node_boxes,node_highlights,node_footer,node_bootstrap toneBlue
class node_akshara,node_events,node_convergence,node_sintillashunz,node_workshops,node_blogs,node_gallery,node_gallerygrid,node_aksharadata,node_convergencedata,node_sintidata,node_workshopdata,node_highlightdata,node_gallerydata toneAmber
class node_adminpage,node_backend,node_api toneMint
class node_adminapi toneRose
class node_visitor toneIndigo
```

## Components

### Site experience

- [Route application](https://github.com/lv2402/vjsv/blob/main/src/App.tsx): `src/App.tsx`
- [Home page](https://github.com/lv2402/vjsv/blob/main/src/pages/Index.tsx): `src/pages/Index.tsx`
- [Site navigation](https://github.com/lv2402/vjsv/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Home hero](https://github.com/lv2402/vjsv/blob/main/src/components/Hero.tsx): `src/components/Hero.tsx`
- [Feature boxes](https://github.com/lv2402/vjsv/blob/main/src/components/Boxes.tsx): `src/components/Boxes.tsx`
- [Recent highlights](https://github.com/lv2402/vjsv/blob/main/src/components/RecentHighlights.tsx): `src/components/RecentHighlights.tsx`
- [Site footer](https://github.com/lv2402/vjsv/blob/main/src/components/Footer.tsx): `src/components/Footer.tsx`
- [Frontend entry](https://github.com/lv2402/vjsv/blob/main/src/main.tsx): `src/main.tsx`

### Cultural content

- [Akshara page](https://github.com/lv2402/vjsv/blob/main/src/pages/Akshara.tsx): `src/pages/Akshara.tsx`
- [Events index](https://github.com/lv2402/vjsv/blob/main/src/pages/Events.tsx): `src/pages/Events.tsx`
- [Convergence](https://github.com/lv2402/vjsv/blob/main/src/pages/Events/Convergence/Convergence.tsx): `src/pages/Events/Convergence/Convergence.tsx`
- [Sintillashunz](https://github.com/lv2402/vjsv/blob/main/src/pages/Events/Sintillashunz/Sintillashunz.tsx): `src/pages/Events/Sintillashunz/Sintillashunz.tsx`
- [Workshops](https://github.com/lv2402/vjsv/blob/main/src/pages/Events/Workshops/Workshops.tsx): `src/pages/Events/Workshops/Workshops.tsx`
- [Creative writing](https://github.com/lv2402/vjsv/blob/main/src/pages/Blogs.tsx): `src/pages/Blogs.tsx`
- [Gallery page](https://github.com/lv2402/vjsv/blob/main/src/pages/Gallery.tsx): `src/pages/Gallery.tsx`
- [Gallery grid](https://github.com/lv2402/vjsv/blob/main/src/components/GalleryGrid.tsx): `src/components/GalleryGrid.tsx`
- [Akshara event data](https://github.com/lv2402/vjsv/blob/main/src/lib/aksharaEvents.ts): `src/lib/aksharaEvents.ts`
- [Convergence event data](https://github.com/lv2402/vjsv/blob/main/src/lib/convergenceEvents.ts): `src/lib/convergenceEvents.ts`
- [Sintillashunz event data](https://github.com/lv2402/vjsv/blob/main/src/lib/sintillashunzEvents.ts): `src/lib/sintillashunzEvents.ts`
- [Workshop event data](https://github.com/lv2402/vjsv/blob/main/src/lib/workshopsEvents.ts): `src/lib/workshopsEvents.ts`
- [Highlight data](https://github.com/lv2402/vjsv/blob/main/src/lib/highlights.ts): `src/lib/highlights.ts`
- [Gallery image data](https://github.com/lv2402/vjsv/blob/main/src/lib/galleryImages.ts): `src/lib/galleryImages.ts`

### Content management

- [Admin console](https://github.com/lv2402/vjsv/blob/main/src/pages/Admin.tsx): `src/pages/Admin.tsx`
- [Backend service](https://github.com/lv2402/vjsv/blob/main/server/main.py): `server/main.py`

### Shared services

- [Admin API client](https://github.com/lv2402/vjsv/blob/main/src/lib/adminApi.ts): `src/lib/adminApi.ts`

### Other components

- **Visitor**
- **HTTP API**

## Connections

- Visitor → Route application: opens (evidence: `src/App.tsx`)
- Frontend entry → Route application: mounts (evidence: `src/main.tsx`)
- Route application → Home page: routes (evidence: `src/App.tsx`)
- Route application → Akshara page: routes (evidence: `src/App.tsx`)
- Route application → Convergence: routes (evidence: `src/App.tsx`)
- Route application → Sintillashunz: routes (evidence: `src/App.tsx`)
- Route application → Workshops: routes (evidence: `src/App.tsx`)
- Route application → Gallery page: routes (evidence: `src/App.tsx`)
- Route application → Creative writing: routes (evidence: `src/App.tsx`)
- Route application → Admin console: routes (evidence: `src/App.tsx`)
- Home page → Site navigation: renders (evidence: `src/pages/Index.tsx`)
- Home page → Home hero: renders (evidence: `src/pages/Index.tsx`)
- Home page → Feature boxes: renders (evidence: `src/pages/Index.tsx`)
- Home page → Recent highlights: renders (evidence: `src/pages/Index.tsx`)
- Home page → Site footer: renders (evidence: `src/pages/Index.tsx`)
- Gallery page → Site navigation: renders (evidence: `src/pages/Gallery.tsx`)
- Gallery page → Gallery grid: renders (evidence: `src/pages/Gallery.tsx`)
- Gallery page → Site footer: renders (evidence: `src/pages/Gallery.tsx`)
- Recent highlights → Admin API client: fetches (evidence: `src/components/RecentHighlights.tsx`)
- Akshara page → Admin API client: fetches (evidence: `src/pages/Akshara.tsx`)
- Convergence → Admin API client: fetches (evidence: `src/pages/Events/Convergence/Convergence.tsx`)
- Sintillashunz → Admin API client: fetches (evidence: `src/pages/Events/Sintillashunz/Sintillashunz.tsx`)
- Workshops → Admin API client: fetches (evidence: `src/pages/Events/Workshops/Workshops.tsx`)
- Creative writing → Admin API client: fetches (evidence: `src/pages/Blogs.tsx`)
- Admin console → Admin API client: manages content (evidence: `src/pages/Admin.tsx`)
- Admin API client → HTTP API: sends requests (evidence: `src/lib/adminApi.ts`)
- Akshara page → Akshara event data: reads
- Convergence → Convergence event data: reads
- Sintillashunz → Sintillashunz event data: reads
- Workshops → Workshop event data: reads
- Recent highlights → Highlight data: reads (evidence: `src/components/RecentHighlights.tsx`)
- Gallery grid → Gallery image data: reads
