# antony-jacob817/my-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/antony-jacob817/my-portfolio
- Repository: https://github.com/antony-jacob817/my-portfolio

## Overview

1. **Overall shape**
   - This is a **single-page portfolio application** built with **React + TypeScript** and bundled with **Vite**.
   - The app is organized as a set of reusable UI components and content sections rather than feature modules or backend services.

2. **App shell and composition**
   - `src/main.tsx` boots the app, and `src/App.tsx` acts as the top-level composition point.
   - The page is assembled from the major sections under `src/components/sections`, likely in a scroll-based one-page layout.

3. **Primary content sections**
   - The main user-facing areas are **Hero, About, Skills, Projects, and Contact**.
   - These sections represent the portfolio narrative flow: introduction → background → capabilities → work → contact.

4. **Layout and navigation**
   - `src/components/layout` contains shared chrome such as **Header** and **BottomNavigation**.
   - This suggests navigation is persistent across sections and designed for quick jumping within the single-page experience.

5. **Shared UI primitives**
   - `src/components/core` holds cross-cutting interactive elements: **ThemeToggle, Loader, CustomCursor, CvDownloadButton, Chatbot**.
   - These are not tied to a specific content section and form the reusable interaction layer of the site.

6. **Theme state boundary**
   - `src/contexts/ThemeContext.tsx` centralizes theme mode state and is consumed by the theme toggle and likely by visual styling across the app.
   - This is the main explicit application state boundary in the repo.

7. **3D / visual enhancement subsystem**
   - `src/components/3d/SkillSphere.tsx` indicates a distinct visual subsystem for animated or 3D-style presentation of skills.
   - It is likely embedded in the Skills section as a presentation enhancement rather than as core app logic.

8. **Data and external integration**
   - `src/utils/github.ts` suggests at least one external data source, probably used to enrich the **Projects** section with GitHub-derived information.
   - This is the clearest sign of a data-fetching boundary in an otherwise mostly static portfolio.

9. **Types and shared contracts**
   - `src/types/index.ts` provides shared TypeScript types for props, content models, or external data shapes.
   - This keeps section components and utility code aligned without introducing heavier state management.

10. **Static assets**
   - `public/Antony_Jacob_CV.pdf` is a static downloadable asset, wired through the CV download button.
   - The `public` directory is also the place for any other directly served files that do not go through the module bundle.

11. **Styling approach**
   - The presence of `tailwind.config.js`, `postcss.config.js`, and `src/index.css` indicates a **Tailwind-based styling stack** with a global stylesheet for base rules and overrides.
   - Styling is likely component-driven, with theme-aware class switching handled through the context.

12. **Build and runtime environment**
   - The repo is configured with standard frontend tooling: **Vite**, **TypeScript**, and **ESLint**.
   - `index.html` is the Vite entry shell, while `tsconfig*.json` and `vite.config.ts` define compile-time and bundling behavior.

13. **Architecture summary for a diagram**
   - The best diagram is a **front-end only SPA** with one central composition layer, a theme-state context, a shared UI layer, and several content sections.
   - The only likely external boundary is optional GitHub data access, plus static asset delivery for the CV PDF.

Main entry points: [`src/App.tsx`](https://github.com/antony-jacob817/my-portfolio/blob/main/src/App.tsx) (App), [`src/types/index.ts`](https://github.com/antony-jacob817/my-portfolio/blob/main/src/types/index.ts) (Types), [`src/components/sections/Skills.tsx`](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/sections/Skills.tsx) (Skills), [`src/components/sections/Projects.tsx`](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/sections/Projects.tsx) (Projects)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_app["App shell"]
  node_node_main(("main.tsx<br/>entrypoint<br/>[main.tsx]"))
  node_node_app["App<br/>composition<br/>[App.tsx]"]
end

subgraph group_group_sections["Content sections"]
  node_node_hero["Hero<br/>section<br/>[Hero.tsx]"]
  node_node_about["About<br/>section<br/>[About.tsx]"]
  node_node_skills["Skills<br/>section<br/>[Skills.tsx]"]
  node_node_projects["Projects<br/>section<br/>[Projects.tsx]"]
  node_node_contact["Contact<br/>section<br/>[Contact.tsx]"]
end

subgraph group_group_ui["Shared UI"]
  node_node_header["Header<br/>navigation<br/>[Header.tsx]"]
  node_node_bottomnav["Bottom Nav<br/>navigation"]
  node_node_theme_toggle["Theme Toggle<br/>control<br/>[ThemeToggle.tsx]"]
  node_node_loader(("Loader<br/>feedback<br/>[Loader.tsx]"))
  node_node_cursor(("Custom Cursor<br/>presentation<br/>[CustomCursor.tsx]"))
  node_node_cv_button["CV Download<br/>asset-link"]
  node_node_chatbot["Chatbot<br/>assistant-ui<br/>[Chatbot.tsx]"]
  node_node_skillsphere{{"Skill Sphere<br/>3d-visual<br/>[SkillSphere.tsx]"}}
end

subgraph group_group_state["State"]
  node_node_theme_ctx[("Theme Context<br/>state-context<br/>[ThemeContext.tsx]")]
end

subgraph group_group_data["Data & assets"]
  node_node_github["GitHub Utils<br/>integration<br/>[github.ts]"]
  node_node_types["Types<br/>contracts<br/>[index.ts]"]
  node_node_cv_pdf["CV PDF<br/>static asset"]
end

subgraph group_group_platform["Platform"]
  node_node_indexcss["index.css<br/>global styles<br/>[index.css]"]
  node_node_tailwind["Tailwind<br/>styling config<br/>[tailwind.config.js]"]
  node_node_vite["Vite<br/>build config<br/>[vite.config.ts]"]
end

node_node_main -->|"renders"| node_node_app
node_node_app -->|"includes"| node_node_header
node_node_app -->|"includes"| node_node_bottomnav
node_node_app -->|"composes"| node_node_hero
node_node_app -->|"composes"| node_node_about
node_node_app -->|"composes"| node_node_skills
node_node_app -->|"composes"| node_node_projects
node_node_app -->|"composes"| node_node_contact
node_node_theme_toggle -->|"reads/writes"| node_node_theme_ctx
node_node_header -->|"contains"| node_node_theme_toggle
node_node_app -->|"uses"| node_node_loader
node_node_app -->|"uses"| node_node_cursor
node_node_app -->|"uses"| node_node_chatbot
node_node_app -->|"uses"| node_node_cv_button
node_node_app -->|"provides"| node_node_theme_ctx
node_node_skills -->|"embeds"| node_node_skillsphere
node_node_projects -->|"fetches"| node_node_github
node_node_cv_button -->|"downloads"| node_node_cv_pdf
node_node_app -->|"shares"| node_node_types
node_node_hero -->|"uses"| node_node_types
node_node_projects -->|"uses"| node_node_types
node_node_about -->|"uses"| node_node_types
node_node_skills -->|"uses"| node_node_types
node_node_contact -->|"uses"| node_node_types
node_node_app -->|"styles"| node_node_indexcss
node_node_app -->|"configures"| node_node_tailwind
node_node_main -->|"bundled by"| node_node_vite

click node_node_main "https://github.com/antony-jacob817/my-portfolio/blob/main/src/main.tsx"
click node_node_app "https://github.com/antony-jacob817/my-portfolio/blob/main/src/App.tsx"
click node_node_header "https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/layout/Header.tsx"
click node_node_bottomnav "https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/layout/BottomNavigation.tsx"
click node_node_theme_toggle "https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/core/ThemeToggle.tsx"
click node_node_loader "https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/core/Loader.tsx"
click node_node_cursor "https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/core/CustomCursor.tsx"
click node_node_cv_button "https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/core/CvDownloadButton.tsx"
click node_node_chatbot "https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/core/Chatbot.tsx"
click node_node_hero "https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/sections/Hero.tsx"
click node_node_about "https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/sections/About.tsx"
click node_node_skills "https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/sections/Skills.tsx"
click node_node_projects "https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/sections/Projects.tsx"
click node_node_contact "https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/sections/Contact.tsx"
click node_node_skillsphere "https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/3d/SkillSphere.tsx"
click node_node_theme_ctx "https://github.com/antony-jacob817/my-portfolio/blob/main/src/contexts/ThemeContext.tsx"
click node_node_github "https://github.com/antony-jacob817/my-portfolio/blob/main/src/utils/github.ts"
click node_node_types "https://github.com/antony-jacob817/my-portfolio/blob/main/src/types/index.ts"
click node_node_cv_pdf "https://github.com/antony-jacob817/my-portfolio/blob/main/public/Antony_Jacob_CV.pdf"
click node_node_indexcss "https://github.com/antony-jacob817/my-portfolio/blob/main/src/index.css"
click node_node_tailwind "https://github.com/antony-jacob817/my-portfolio/blob/main/tailwind.config.js"
click node_node_vite "https://github.com/antony-jacob817/my-portfolio/blob/main/vite.config.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_node_main,node_node_app toneBlue
class node_node_hero,node_node_about,node_node_skills,node_node_projects,node_node_contact toneAmber
class node_node_header,node_node_bottomnav,node_node_theme_toggle,node_node_loader,node_node_cursor,node_node_cv_button,node_node_chatbot,node_node_skillsphere toneMint
class node_node_theme_ctx toneRose
class node_node_github,node_node_types,node_node_cv_pdf toneIndigo
class node_node_indexcss,node_node_tailwind,node_node_vite toneTeal
```

## Components

### App shell

Bootstrapping and top-level page composition.

- [main.tsx](https://github.com/antony-jacob817/my-portfolio/blob/main/src/main.tsx): entrypoint · Bootstraps the React app. · `src/main.tsx`
- [App](https://github.com/antony-jacob817/my-portfolio/blob/main/src/App.tsx): composition · Top-level page assembly for the portfolio. · `src/App.tsx`

### Content sections

Main one-page portfolio narrative sections.

- [Hero](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/sections/Hero.tsx): section · Introductory landing section. · `src/components/sections/Hero.tsx`
- [About](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/sections/About.tsx): section · Background and personal summary. · `src/components/sections/About.tsx`
- [Skills](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/sections/Skills.tsx): section · Capabilities overview and skill presentation. · `src/components/sections/Skills.tsx`
- [Projects](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/sections/Projects.tsx): section · Work showcase and portfolio items. · `src/components/sections/Projects.tsx`
- [Contact](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/sections/Contact.tsx): section · Reach-out and contact details. · `src/components/sections/Contact.tsx`

### Shared UI

Reusable chrome and interactive primitives.

- [Header](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/layout/Header.tsx): navigation · Persistent top navigation chrome. · `src/components/layout/Header.tsx`
- [Bottom Nav](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/layout/BottomNavigation.tsx): navigation · Secondary persistent section navigation. · `src/components/layout/BottomNavigation.tsx`
- [Theme Toggle](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/core/ThemeToggle.tsx): control · User-facing theme switcher. · `src/components/core/ThemeToggle.tsx`
- [Loader](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/core/Loader.tsx): feedback · Loading or transition indicator. · `src/components/core/Loader.tsx`
- [Custom Cursor](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/core/CustomCursor.tsx): presentation · Enhanced pointer interaction layer. · `src/components/core/CustomCursor.tsx`
- [CV Download](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/core/CvDownloadButton.tsx): asset-link · Triggers download of the resume PDF. · `src/components/core/CvDownloadButton.tsx`
- [Chatbot](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/core/Chatbot.tsx): assistant-ui · Interactive conversational UI element. · `src/components/core/Chatbot.tsx`
- [Skill Sphere](https://github.com/antony-jacob817/my-portfolio/blob/main/src/components/3d/SkillSphere.tsx): 3d-visual · Animated or 3D skill visualization. · `src/components/3d/SkillSphere.tsx`

### State

Cross-cutting application state boundary.

- [Theme Context](https://github.com/antony-jacob817/my-portfolio/blob/main/src/contexts/ThemeContext.tsx): state-context · Central theme mode state and provider. · `src/contexts/ThemeContext.tsx`

### Data & assets

External data access and static downloadable content.

- [GitHub Utils](https://github.com/antony-jacob817/my-portfolio/blob/main/src/utils/github.ts): integration · External GitHub data access for portfolio content. · `src/utils/github.ts`
- [Types](https://github.com/antony-jacob817/my-portfolio/blob/main/src/types/index.ts): contracts · Shared TypeScript domain and prop types. · `src/types/index.ts`
- [CV PDF](https://github.com/antony-jacob817/my-portfolio/blob/main/public/Antony_Jacob_CV.pdf): static asset · Downloadable resume document. · `public/Antony_Jacob_CV.pdf`

### Platform

Bundling, styling, and runtime entry layers.

- [index.css](https://github.com/antony-jacob817/my-portfolio/blob/main/src/index.css): global styles · Global stylesheet and Tailwind base overrides. · `src/index.css`
- [Tailwind](https://github.com/antony-jacob817/my-portfolio/blob/main/tailwind.config.js): styling config · Utility-first styling configuration. · `tailwind.config.js`
- [Vite](https://github.com/antony-jacob817/my-portfolio/blob/main/vite.config.ts): build config · Bundling and dev-server configuration. · `vite.config.ts`

## Connections

- main.tsx → App: renders · Bootstraps the application shell.
- App → Header: includes · Composes persistent navigation chrome.
- App → Bottom Nav: includes · Composes persistent section navigation.
- App → Hero: composes · Renders the landing section.
- App → About: composes · Renders the background section.
- App → Skills: composes · Renders the skills section.
- App → Projects: composes · Renders the work showcase section.
- App → Contact: composes · Renders the contact section.
- Theme Toggle → Theme Context: reads/writes · Switches the active theme mode.
- Header → Theme Toggle: contains · Exposes theme switching in the top bar.
- App → Loader: uses · Provides loading feedback within the shell.
- App → Custom Cursor: uses · Adds global pointer interaction.
- App → Chatbot: uses · Mounts the assistant interaction layer.
- App → CV Download: uses · Offers access to the resume download.
- App → Theme Context: provides · Wraps the page with theme state.
- Skills → Skill Sphere: embeds · Uses the visual skill presentation component.
- Projects → GitHub Utils: fetches · Enriches project content from GitHub data.
- CV Download → CV PDF: downloads · Links to the static resume asset.
- App → Types: shares · Uses common types across sections and utilities.
- Hero → Types: uses · Consumes shared content and prop contracts.
- Projects → Types: uses · Consumes shared content and data contracts.
- About → Types: uses · Consumes shared content and prop contracts.
- Skills → Types: uses · Consumes shared content and prop contracts.
- Contact → Types: uses · Consumes shared content and prop contracts.
- App → index.css: styles · Applies global base styling.
- App → Tailwind: configures · Uses Tailwind for utility styling.
- main.tsx → Vite: bundled by · Runs within the Vite toolchain.
