# baranidharan-sys/admigo architecture

> Architecture diagram of the GitHub repository baranidharan-sys/admigo, 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/baranidharan-sys/admigo
- Repository: https://github.com/baranidharan-sys/admigo

## Overview

AdmiGo is a student-facing Indian college admissions planning app. Students maintain a profile, choose a college and course, and use the dashboard’s admission, cost, comparison, portfolio, and report views to assess options; reports can be downloaded as PDFs. The app owns shared profile, theme, and active-college state, while calculation utilities provide an internal analysis layer over bundled college data. The README only describes running the app, so feature scope comes primarily from component names and the shown UI excerpts; unsampled view-to-view behavior is not inferred.

Main entry points: [`src/App.tsx`](https://github.com/baranidharan-sys/admigo/blob/master/src/App.tsx) (App State & Tabs), [`src/utils/calculations.ts`](https://github.com/baranidharan-sys/admigo/blob/master/src/utils/calculations.ts) (Admission & Cost Calculations), [`src/components/ProfileAvatar.tsx`](https://github.com/baranidharan-sys/admigo/blob/master/src/components/ProfileAvatar.tsx) (Profile Avatar), [`src/components/Navbar.tsx`](https://github.com/baranidharan-sys/admigo/blob/master/src/components/Navbar.tsx) (Navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard"]
  node_app["App State &amp; Tabs<br/>[App.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_status["Live Status"]
end

subgraph group_planning["Admissions Planning"]
  node_selector["College Selector"]
  node_overview["College Overview"]
  node_admission["Admission Chance"]
  node_financial["Financial Planner"]
end

subgraph group_insights["Analysis &amp; Reports"]
  node_volatility["Cutoff Volatility"]
  node_comparison["College Comparison"]
  node_portfolio["Portfolio Builder"]
  node_report["Personalized Report"]
  node_pdf["PDF Generator<br/>[pdfGenerator.ts]"]
end

subgraph group_profile["Student Profile"]
  node_auth["Authentication Page<br/>[AuthPage.tsx]"]
  node_profilemodal["Profile &amp; Preferences"]
  node_avatar["Profile Avatar<br/>[ProfileAvatar.tsx]"]
end

subgraph group_logic["Data &amp; Calculations"]
  node_college_data["College Data<br/>[colleges.ts]"]
  node_calculations["Admission &amp; Cost Calculations<br/>[calculations.ts]"]
end

node_student(("Student"))
node_browser_storage[("Browser Local Storage")]

node_student -->|"uses dashboard"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_status
node_app -->|"renders"| node_selector
node_app -->|"renders"| node_overview
node_app -->|"renders"| node_admission
node_app -->|"renders"| node_financial
node_app -->|"renders"| node_volatility
node_app -->|"renders"| node_comparison
node_app -->|"renders"| node_portfolio
node_app -->|"renders"| node_report
node_app -->|"renders"| node_auth
node_app -->|"renders"| node_profilemodal
node_app -->|"loads initial college"| node_college_data
node_app -->|"reads and writes"| node_browser_storage
node_selector -->|"filters college data"| node_college_data
node_overview -->|"uses calculations"| node_calculations
node_admission -->|"uses calculations"| node_calculations
node_financial -->|"formats costs"| node_calculations
node_volatility -->|"uses calculations"| node_calculations
node_comparison -->|"uses calculations"| node_calculations
node_portfolio -->|"uses calculations"| node_calculations
node_report -->|"generates PDF"| node_pdf
node_auth -->|"uses avatar"| node_avatar
node_profilemodal -->|"renders avatar"| node_avatar
node_navbar -->|"uses avatar"| node_avatar

click node_app "https://github.com/baranidharan-sys/admigo/blob/master/src/App.tsx"
click node_navbar "https://github.com/baranidharan-sys/admigo/blob/master/src/components/Navbar.tsx"
click node_status "https://github.com/baranidharan-sys/admigo/blob/master/src/components/LiveStatusHeader.tsx"
click node_selector "https://github.com/baranidharan-sys/admigo/blob/master/src/components/CollegeSelector.tsx"
click node_overview "https://github.com/baranidharan-sys/admigo/blob/master/src/components/ActiveCollegeOverview.tsx"
click node_admission "https://github.com/baranidharan-sys/admigo/blob/master/src/components/AdmissionChanceView.tsx"
click node_financial "https://github.com/baranidharan-sys/admigo/blob/master/src/components/FinancialPlannerView.tsx"
click node_volatility "https://github.com/baranidharan-sys/admigo/blob/master/src/components/CutoffVolatilityView.tsx"
click node_comparison "https://github.com/baranidharan-sys/admigo/blob/master/src/components/CollegeComparisonView.tsx"
click node_portfolio "https://github.com/baranidharan-sys/admigo/blob/master/src/components/PortfolioBuilderView.tsx"
click node_report "https://github.com/baranidharan-sys/admigo/blob/master/src/components/PersonalizedReportView.tsx"
click node_pdf "https://github.com/baranidharan-sys/admigo/blob/master/src/utils/pdfGenerator.ts"
click node_auth "https://github.com/baranidharan-sys/admigo/blob/master/src/components/AuthPage.tsx"
click node_profilemodal "https://github.com/baranidharan-sys/admigo/blob/master/src/components/StudentProfileModal.tsx"
click node_avatar "https://github.com/baranidharan-sys/admigo/blob/master/src/components/ProfileAvatar.tsx"
click node_college_data "https://github.com/baranidharan-sys/admigo/blob/master/src/data/colleges.ts"
click node_calculations "https://github.com/baranidharan-sys/admigo/blob/master/src/utils/calculations.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_app,node_navbar,node_status toneBlue
class node_selector,node_overview,node_admission,node_financial,node_browser_storage toneAmber
class node_volatility,node_comparison,node_portfolio,node_report,node_pdf toneMint
class node_auth,node_profilemodal,node_avatar toneRose
class node_college_data,node_calculations,node_student toneIndigo
```

## Components

### Dashboard

- [App State & Tabs](https://github.com/baranidharan-sys/admigo/blob/master/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/baranidharan-sys/admigo/blob/master/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Live Status](https://github.com/baranidharan-sys/admigo/blob/master/src/components/LiveStatusHeader.tsx): `src/components/LiveStatusHeader.tsx`

### Admissions Planning

- [College Selector](https://github.com/baranidharan-sys/admigo/blob/master/src/components/CollegeSelector.tsx): `src/components/CollegeSelector.tsx`
- [College Overview](https://github.com/baranidharan-sys/admigo/blob/master/src/components/ActiveCollegeOverview.tsx): `src/components/ActiveCollegeOverview.tsx`
- [Admission Chance](https://github.com/baranidharan-sys/admigo/blob/master/src/components/AdmissionChanceView.tsx): `src/components/AdmissionChanceView.tsx`
- [Financial Planner](https://github.com/baranidharan-sys/admigo/blob/master/src/components/FinancialPlannerView.tsx): `src/components/FinancialPlannerView.tsx`

### Analysis & Reports

- [Cutoff Volatility](https://github.com/baranidharan-sys/admigo/blob/master/src/components/CutoffVolatilityView.tsx): `src/components/CutoffVolatilityView.tsx`
- [College Comparison](https://github.com/baranidharan-sys/admigo/blob/master/src/components/CollegeComparisonView.tsx): `src/components/CollegeComparisonView.tsx`
- [Portfolio Builder](https://github.com/baranidharan-sys/admigo/blob/master/src/components/PortfolioBuilderView.tsx): `src/components/PortfolioBuilderView.tsx`
- [Personalized Report](https://github.com/baranidharan-sys/admigo/blob/master/src/components/PersonalizedReportView.tsx): `src/components/PersonalizedReportView.tsx`
- [PDF Generator](https://github.com/baranidharan-sys/admigo/blob/master/src/utils/pdfGenerator.ts): `src/utils/pdfGenerator.ts`

### Student Profile

- [Authentication Page](https://github.com/baranidharan-sys/admigo/blob/master/src/components/AuthPage.tsx): `src/components/AuthPage.tsx`
- [Profile & Preferences](https://github.com/baranidharan-sys/admigo/blob/master/src/components/StudentProfileModal.tsx): `src/components/StudentProfileModal.tsx`
- [Profile Avatar](https://github.com/baranidharan-sys/admigo/blob/master/src/components/ProfileAvatar.tsx): `src/components/ProfileAvatar.tsx`

### Data & Calculations

- [College Data](https://github.com/baranidharan-sys/admigo/blob/master/src/data/colleges.ts): `src/data/colleges.ts`
- [Admission & Cost Calculations](https://github.com/baranidharan-sys/admigo/blob/master/src/utils/calculations.ts): `src/utils/calculations.ts`

### Other components

- **Student**
- **Browser Local Storage**

## Connections

- Student → App State & Tabs: uses dashboard (evidence: `src/App.tsx`)
- App State & Tabs → Navigation: renders (evidence: `src/App.tsx`)
- App State & Tabs → Live Status: renders (evidence: `src/App.tsx`)
- App State & Tabs → College Selector: renders (evidence: `src/App.tsx`)
- App State & Tabs → College Overview: renders (evidence: `src/App.tsx`)
- App State & Tabs → Admission Chance: renders (evidence: `src/App.tsx`)
- App State & Tabs → Financial Planner: renders (evidence: `src/App.tsx`)
- App State & Tabs → Cutoff Volatility: renders (evidence: `src/App.tsx`)
- App State & Tabs → College Comparison: renders (evidence: `src/App.tsx`)
- App State & Tabs → Portfolio Builder: renders (evidence: `src/App.tsx`)
- App State & Tabs → Personalized Report: renders (evidence: `src/App.tsx`)
- App State & Tabs → Authentication Page: renders (evidence: `src/App.tsx`)
- App State & Tabs → Profile & Preferences: renders (evidence: `src/App.tsx`)
- App State & Tabs → College Data: loads initial college (evidence: `src/App.tsx`)
- App State & Tabs → Browser Local Storage: reads and writes (evidence: `src/App.tsx`)
- College Selector → College Data: filters college data (evidence: `src/components/CollegeSelector.tsx`)
- College Overview → Admission & Cost Calculations: uses calculations (evidence: `src/components/ActiveCollegeOverview.tsx`)
- Admission Chance → Admission & Cost Calculations: uses calculations (evidence: `src/components/AdmissionChanceView.tsx`)
- Financial Planner → Admission & Cost Calculations: formats costs (evidence: `src/components/FinancialPlannerView.tsx`)
- Cutoff Volatility → Admission & Cost Calculations: uses calculations (evidence: `src/components/CutoffVolatilityView.tsx`)
- College Comparison → Admission & Cost Calculations: uses calculations (evidence: `src/components/CollegeComparisonView.tsx`)
- Portfolio Builder → Admission & Cost Calculations: uses calculations (evidence: `src/components/PortfolioBuilderView.tsx`)
- Personalized Report → PDF Generator: generates PDF (evidence: `src/components/PersonalizedReportView.tsx`)
- Authentication Page → Profile Avatar: uses avatar (evidence: `src/components/AuthPage.tsx`)
- Profile & Preferences → Profile Avatar: renders avatar (evidence: `src/components/StudentProfileModal.tsx`)
- Navigation → Profile Avatar: uses avatar (evidence: `src/components/Navbar.tsx`)
