# muhil-amuthan/muhil-amuthan-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/muhil-amuthan/muhil-amuthan-portfolio
- Repository: https://github.com/muhil-amuthan/muhil-amuthan-portfolio

## Overview

This is a client-rendered personal portfolio: visitors enter the homepage, browse profile and work sections, ask portfolio questions, or submit a contact message. A separate admin route provides client-side management of portfolio information. The graph preserves the README’s documented capabilities; unsampled feature details and wiring are shown only where documented, and edge evidence is limited to the excerpts, SOURCE INDEX references, and README.

Main entry points: [`src/App.tsx`](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/App.tsx) (App routing), [`src/sections/Contact.tsx`](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Contact.tsx) (Contact form), [`src/pages/AdminDashboard.tsx`](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/pages/AdminDashboard.tsx) (Admin dashboard), [`src/data`](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/tree/main/src/data) (Portfolio datasets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["App shell"]
  node_app["App routing<br/>[App.tsx]"]
  node_entry["React entry<br/>[main.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_cursor["Custom cursor<br/>[CustomCursor.tsx]"]
  node_particles["Particle background"]
  node_loading["Loading screen<br/>[LoadingScreen.tsx]"]
  node_toast["Toast notices<br/>[Toast.tsx]"]
  node_inview["Visibility hook<br/>[useInView.ts]"]
end

subgraph group_portfolio["Portfolio experience"]
  node_hero["Hero introduction<br/>[Hero.tsx]"]
  node_profile["Profile sections<br/>[About.tsx]"]
  node_skills["Skills<br/>[Skills.tsx]"]
  node_experience["Experience timeline<br/>[Experience.tsx]"]
  node_projects["Projects showcase<br/>[Projects.tsx]"]
  node_certs["Certifications gallery<br/>[Certifications.tsx]"]
  node_achievements["Achievements<br/>[Achievements.tsx]"]
  node_coding["Coding profiles<br/>[CodingProfiles.tsx]"]
  node_contact["Contact form<br/>[Contact.tsx]"]
  node_footer["Footer links<br/>[Footer.tsx]"]
  node_chatbot["Portfolio chatbot<br/>[ChatBot.tsx]"]
end

subgraph group_content["Portfolio content"]
  node_datasets["Portfolio datasets"]
  node_knowledge["Chatbot knowledge"]
end

subgraph group_admin["Admin management"]
  node_adminlogin["Admin login<br/>[AdminLogin.tsx]"]
  node_dashboard["Admin dashboard<br/>[AdminDashboard.tsx]"]
  node_browserstore[("Browser local storage")]
end

node_visitor(("Portfolio visitor"))
node_formspree["Formspree"]

node_visitor -->|"opens portfolio"| node_entry
node_entry -->|"renders"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_cursor
node_app -->|"renders"| node_particles
node_app -->|"renders"| node_loading
node_app -->|"routes to"| node_hero
node_app -->|"renders"| node_profile
node_app -->|"renders"| node_skills
node_app -->|"renders"| node_experience
node_app -->|"renders"| node_projects
node_app -->|"renders"| node_certs
node_app -->|"renders"| node_achievements
node_app -->|"renders"| node_contact
node_app -->|"renders"| node_footer
node_app -->|"renders"| node_chatbot
node_app -->|"routes to"| node_adminlogin
node_app -->|"routes to"| node_dashboard
node_visitor -->|"sends inquiry"| node_contact
node_contact -->|"submits message"| node_formspree
node_contact -->|"uses notices"| node_toast
node_chatbot -->|"matches questions"| node_knowledge
node_experience -->|"reads experience and timeline"| node_datasets
node_projects -->|"reads project data"| node_datasets
node_certs -->|"reads credentials"| node_datasets
node_profile -->|"uses visibility hook"| node_inview
node_adminlogin -.->|"grants admin access"| node_dashboard
node_dashboard -->|"stores edits"| node_browserstore

click node_app "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/App.tsx"
click node_entry "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/main.tsx"
click node_navbar "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/components/Navbar.tsx"
click node_cursor "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/components/CustomCursor.tsx"
click node_particles "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/components/ParticleBackground.tsx"
click node_loading "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/components/LoadingScreen.tsx"
click node_toast "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/components/Toast.tsx"
click node_hero "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Hero.tsx"
click node_profile "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/About.tsx"
click node_skills "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Skills.tsx"
click node_experience "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Experience.tsx"
click node_projects "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Projects.tsx"
click node_certs "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Certifications.tsx"
click node_achievements "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Achievements.tsx"
click node_coding "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/CodingProfiles.tsx"
click node_contact "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Contact.tsx"
click node_footer "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Footer.tsx"
click node_chatbot "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/ChatBot.tsx"
click node_inview "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/hooks/useInView.ts"
click node_datasets "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/tree/main/src/data"
click node_knowledge "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/data/chatbot-knowledge.ts"
click node_adminlogin "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/pages/AdminLogin.tsx"
click node_dashboard "https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/pages/AdminDashboard.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_entry,node_navbar,node_cursor,node_particles,node_loading,node_toast,node_inview toneBlue
class node_hero,node_profile,node_skills,node_experience,node_projects,node_certs,node_achievements,node_coding,node_contact,node_footer,node_chatbot toneAmber
class node_datasets,node_knowledge toneMint
class node_adminlogin,node_dashboard,node_browserstore toneRose
class node_visitor,node_formspree toneIndigo
```

## Components

### App shell

- [App routing](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/App.tsx): `src/App.tsx`
- [React entry](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/main.tsx): `src/main.tsx`
- [Navigation](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Custom cursor](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/components/CustomCursor.tsx): `src/components/CustomCursor.tsx`
- [Particle background](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/components/ParticleBackground.tsx): `src/components/ParticleBackground.tsx`
- [Loading screen](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/components/LoadingScreen.tsx): `src/components/LoadingScreen.tsx`
- [Toast notices](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/components/Toast.tsx): `src/components/Toast.tsx`
- [Visibility hook](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/hooks/useInView.ts): `src/hooks/useInView.ts`

### Portfolio experience

- [Hero introduction](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Hero.tsx): `src/sections/Hero.tsx`
- [Profile sections](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/About.tsx): `src/sections/About.tsx`
- [Skills](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Skills.tsx): `src/sections/Skills.tsx`
- [Experience timeline](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Experience.tsx): `src/sections/Experience.tsx`
- [Projects showcase](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Projects.tsx): `src/sections/Projects.tsx`
- [Certifications gallery](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Certifications.tsx): `src/sections/Certifications.tsx`
- [Achievements](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Achievements.tsx): `src/sections/Achievements.tsx`
- [Coding profiles](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/CodingProfiles.tsx): `src/sections/CodingProfiles.tsx`
- [Contact form](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Contact.tsx): `src/sections/Contact.tsx`
- [Footer links](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/Footer.tsx): `src/sections/Footer.tsx`
- [Portfolio chatbot](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/sections/ChatBot.tsx): `src/sections/ChatBot.tsx`

### Portfolio content

- [Portfolio datasets](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/tree/main/src/data): `src/data`
- [Chatbot knowledge](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/data/chatbot-knowledge.ts): `src/data/chatbot-knowledge.ts`

### Admin management

- [Admin login](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/pages/AdminLogin.tsx): `src/pages/AdminLogin.tsx`
- [Admin dashboard](https://github.com/muhil-amuthan/muhil-amuthan-portfolio/blob/main/src/pages/AdminDashboard.tsx): `src/pages/AdminDashboard.tsx`
- **Browser local storage**

### Other components

- **Portfolio visitor**
- **Formspree**

## Connections

- Portfolio visitor → React entry: opens portfolio (evidence: `README.md`)
- React entry → App routing: renders (evidence: `src/main.tsx`)
- App routing → Navigation: renders (evidence: `src/App.tsx`)
- App routing → Custom cursor: renders (evidence: `src/App.tsx`)
- App routing → Particle background: renders (evidence: `src/App.tsx`)
- App routing → Loading screen: renders (evidence: `src/App.tsx`)
- App routing → Hero introduction: routes to (evidence: `src/App.tsx`)
- App routing → Profile sections: renders (evidence: `src/App.tsx`)
- App routing → Skills: renders (evidence: `src/App.tsx`)
- App routing → Experience timeline: renders (evidence: `src/App.tsx`)
- App routing → Projects showcase: renders (evidence: `src/App.tsx`)
- App routing → Certifications gallery: renders (evidence: `src/App.tsx`)
- App routing → Achievements: renders (evidence: `src/App.tsx`)
- App routing → Contact form: renders (evidence: `src/App.tsx`)
- App routing → Footer links: renders (evidence: `src/App.tsx`)
- App routing → Portfolio chatbot: renders (evidence: `src/App.tsx`)
- App routing → Admin login: routes to (evidence: `src/App.tsx`)
- App routing → Admin dashboard: routes to (evidence: `src/App.tsx`)
- Portfolio visitor → Contact form: sends inquiry (evidence: `README.md`)
- Contact form → Formspree: submits message (evidence: `README.md`)
- Contact form → Toast notices: uses notices (evidence: `src/sections/Contact.tsx`)
- Portfolio chatbot → Chatbot knowledge: matches questions (evidence: `src/sections/ChatBot.tsx`)
- Experience timeline → Portfolio datasets: reads experience and timeline (evidence: `src/sections/Experience.tsx`)
- Projects showcase → Portfolio datasets: reads project data (evidence: `src/sections/Projects.tsx`)
- Certifications gallery → Portfolio datasets: reads credentials (evidence: `src/sections/Certifications.tsx`)
- Profile sections → Visibility hook: uses visibility hook (evidence: `src/sections/About.tsx`)
- Admin login → Admin dashboard: grants admin access
- Admin dashboard → Browser local storage: stores edits (evidence: `README.md`)
