# esai-keshav/annamalai-university-cgpa architecture

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

- Interactive diagram: https://gitdiagram.com/esai-keshav/annamalai-university-cgpa
- Repository: https://github.com/esai-keshav/annamalai-university-cgpa

## Overview

1. This repository is a small client-side application for an “Annamalai University CGPA calculator.” The architecture is that of a static single-page app rather than a multi-service system.

2. The runtime stack is React with Vite. `src/main.jsx` is the application bootstrap point, and `src/App.jsx` is the top-level UI component that likely contains the calculator logic and screen composition.

3. `index.html` is the single HTML host page. Vite injects the React bundle into this page, so the browser loads one app shell and the rest of the experience is rendered client-side.

4. `src/index.css` provides global styling for the app. This suggests the UI is styled centrally rather than through a larger component library or CSS framework visible in the repo tree.

5. `src/assets` and `public` are the static asset boundaries. `src/assets` is for imports managed by the module bundler, while `public` is for files served directly without bundling, which is typical for icons, images, or other static resources.

6. There is no evidence of a backend, database, or API layer in the repository tree. That means the calculator likely performs its computations entirely in the browser and does not depend on server-side state.

7. The core data flow is likely user input → calculator state in `App.jsx` → CGPA computation → rendered result in the same React tree. For an architecture diagram, the main interactive boundary is the UI component, not an external service.

8. `vite.config.js` defines build and dev-server behavior. This matters because the app is packaged as a front-end bundle and probably deployed as static files.

9. `eslint.config.js` indicates a linting layer for code quality and consistency during development. It is part of the tooling boundary rather than the runtime architecture.

10. The `.github/workflows/deploy.yml` file shows automated deployment in CI/CD. The app is likely built and published from GitHub Actions to a static host, which is the only infrastructure component visible in the repo.

11. `package.json` and `package-lock.json` define the Node.js dependency and build toolchain. Even though the app is browser-facing, Node is the build-time runtime used to install dependencies, lint, and bundle the app.

12. In summary, the system architecture is: static hosting/CD pipeline at the edge, Vite build layer in the middle, and a React single-page calculator UI at the core, with all CGPA logic and state contained on the client side.

Main entry points: [`src/App.jsx`](https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/src/App.jsx) (Calculator), [`package.json`](https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/package.json) (Dependencies), [`vite.config.js`](https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/vite.config.js) (Vite config), [`.github/workflows/deploy.yml`](https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/.github/workflows/deploy.yml) (Deploy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime UI"]
  node_index_html["App shell<br/>html host<br/>[index.html]"]
  node_main_jsx(("Bootstrap<br/>react entry<br/>[main.jsx]"))
  node_app_jsx["Calculator<br/>react screen<br/>[App.jsx]"]
  node_styles_css["Global styles<br/>css<br/>[index.css]"]
  node_src_assets[("Bundled assets<br/>static assets")]
  node_public_dir[("Public files<br/>static files")]
end

subgraph group_tooling["Build Tooling"]
  node_vite_config{{"Vite config<br/>build config<br/>[vite.config.js]"}}
  node_package_json["Dependencies<br/>node manifest<br/>[package.json]"]
  node_eslint_config["Lint rules<br/>quality config<br/>[eslint.config.js]"]
end

subgraph group_delivery["Delivery"]
  node_deploy_workflow["Deploy<br/>ci workflow<br/>[deploy.yml]"]
end

node_deploy_workflow -->|"builds with"| node_vite_config
node_deploy_workflow -->|"installs"| node_package_json
node_vite_config -->|"serves"| node_index_html
node_index_html -->|"loads"| node_main_jsx
node_main_jsx -->|"mounts"| node_app_jsx
node_app_jsx -->|"styles"| node_styles_css
node_app_jsx -->|"imports"| node_src_assets
node_app_jsx -->|"references"| node_public_dir
node_app_jsx -.->|"computes"| node_app_jsx
node_package_json -->|"drives"| node_vite_config
node_package_json -->|"supports"| node_eslint_config

click node_index_html "https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/index.html"
click node_main_jsx "https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/src/main.jsx"
click node_app_jsx "https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/src/App.jsx"
click node_styles_css "https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/src/index.css"
click node_src_assets "https://github.com/esai-keshav/annamalai-university-cgpa/tree/main/src/assets"
click node_public_dir "https://github.com/esai-keshav/annamalai-university-cgpa/tree/main/public"
click node_vite_config "https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/vite.config.js"
click node_package_json "https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/package.json"
click node_eslint_config "https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/eslint.config.js"
click node_deploy_workflow "https://github.com/esai-keshav/annamalai-university-cgpa/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_index_html,node_main_jsx,node_app_jsx,node_styles_css,node_src_assets,node_public_dir toneBlue
class node_vite_config,node_package_json,node_eslint_config toneAmber
class node_deploy_workflow toneMint
```

## Components

### Runtime UI

Client-side app shell and React calculator

- [App shell](https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/index.html): html host · Single HTML entry point that mounts the React bundle · `index.html`
- [Bootstrap](https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/src/main.jsx): react entry · Starts the React app and renders the top-level component · `src/main.jsx`
- [Calculator](https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/src/App.jsx): react screen · Top-level UI and CGPA calculation state/logic · `src/App.jsx`
- [Global styles](https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/src/index.css): css · Shared app-wide styling · `src/index.css`
- [Bundled assets](https://github.com/esai-keshav/annamalai-university-cgpa/tree/main/src/assets): static assets · Images and other imports handled by the module bundler · `src/assets`
- [Public files](https://github.com/esai-keshav/annamalai-university-cgpa/tree/main/public): static files · Files served directly without bundling · `public`

### Build Tooling

Vite, linting, and Node package setup

- [Vite config](https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/vite.config.js): build config · Dev server and production bundle settings · `vite.config.js`
- [Dependencies](https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/package.json): node manifest · Project scripts and build-time dependencies · `package.json`
- [Lint rules](https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/eslint.config.js): quality config · Code style and quality enforcement · `eslint.config.js`

### Delivery

Static hosting and CI deployment

- [Deploy](https://github.com/esai-keshav/annamalai-university-cgpa/blob/main/.github/workflows/deploy.yml): ci workflow · Automated build and publish pipeline · `.github/workflows/deploy.yml`

## Connections

- Deploy → Vite config: builds with · CI uses the Vite build setup
- Deploy → Dependencies: installs · Workflow relies on Node dependencies and scripts
- Vite config → App shell: serves · Vite uses the HTML entry as the app shell
- App shell → Bootstrap: loads · Browser loads the React bundle into the host page
- Bootstrap → Calculator: mounts · Bootstrap renders the top-level calculator component
- Calculator → Global styles: styles · UI uses the global stylesheet
- Calculator → Bundled assets: imports · Component may consume bundled static assets
- Calculator → Public files: references · App can use directly served static files
- Calculator → Calculator: computes · Client-side state and CGPA calculation stay within the UI
- Dependencies → Vite config: drives · Scripts and dependencies support the Vite toolchain
- Dependencies → Lint rules: supports · Project metadata and scripts support linting
