# aadilsood014/engineering-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/aadilsood014/engineering-portfolio
- Repository: https://github.com/aadilsood014/engineering-portfolio

## Overview

This is a Next.js engineering portfolio: visitors enter the homepage, browse project and about pages, and view project write-ups with images, videos, and embedded code. A global animated gear train is mounted by the root layout and rendered from reusable gear shapes. Project pages document distinct work, including a transistor adder, measurement automation, and robotics. The LSM page presents a Python workflow as displayed code, not as code executed by this website. Relationships are limited to visible links, imports, and asset references in the excerpts.

Main entry points: [`app/page.tsx`](https://github.com/aadilsood014/engineering-portfolio/blob/main/app/page.tsx) (Homepage), [`app/About/page.tsx`](https://github.com/aadilsood014/engineering-portfolio/blob/main/app/About/page.tsx) (About page), [`app/projects/fourBit/page.tsx`](https://github.com/aadilsood014/engineering-portfolio/blob/main/app/projects/fourBit/page.tsx) (Four-bit adder), [`app/components/GearTrain.tsx`](https://github.com/aadilsood014/engineering-portfolio/blob/main/app/components/GearTrain.tsx) (Gear train)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Portfolio pages"]
  node_home["Homepage<br/>[page.tsx]"]
  node_about["About page<br/>[page.tsx]"]
  node_layout["Root layout<br/>[layout.tsx]"]
end

subgraph group_projects["Project showcases"]
  node_fourbit["Four-bit adder<br/>[page.tsx]"]
  node_lsm["LSM automation<br/>[page.tsx]"]
  node_project1["Sensor claw<br/>[page.tsx]"]
  node_project2["Robotics project<br/>[page.tsx]"]
end

subgraph group_visuals["Animated decoration"]
  node_geartrain["Gear train<br/>[GearTrain.tsx]"]
  node_gear["Gear shape<br/>[Gear.tsx]"]
end

subgraph group_media["Public media"]
  node_media["Static media"]
end

node_visitor(("Portfolio visitor"))

node_visitor -->|"opens"| node_home
node_home -->|"links to"| node_about
node_home -->|"links to"| node_fourbit
node_home -->|"links to"| node_lsm
node_about -->|"links to"| node_home
node_fourbit -->|"links to"| node_home
node_project1 -->|"links to"| node_home
node_project2 -->|"links to"| node_home
node_layout -->|"renders"| node_geartrain
node_geartrain -->|"renders"| node_gear
node_about -->|"displays"| node_media
node_fourbit -->|"displays"| node_media

click node_home "https://github.com/aadilsood014/engineering-portfolio/blob/main/app/page.tsx"
click node_about "https://github.com/aadilsood014/engineering-portfolio/blob/main/app/About/page.tsx"
click node_fourbit "https://github.com/aadilsood014/engineering-portfolio/blob/main/app/projects/fourBit/page.tsx"
click node_lsm "https://github.com/aadilsood014/engineering-portfolio/blob/main/app/projects/lsm/page.tsx"
click node_project1 "https://github.com/aadilsood014/engineering-portfolio/blob/main/app/projects/project-1/page.tsx"
click node_project2 "https://github.com/aadilsood014/engineering-portfolio/blob/main/app/projects/project-2/page.tsx"
click node_layout "https://github.com/aadilsood014/engineering-portfolio/blob/main/app/layout.tsx"
click node_geartrain "https://github.com/aadilsood014/engineering-portfolio/blob/main/app/components/GearTrain.tsx"
click node_gear "https://github.com/aadilsood014/engineering-portfolio/blob/main/app/components/Gear.tsx"
click node_media "https://github.com/aadilsood014/engineering-portfolio/tree/main/public"

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_home,node_about,node_layout toneBlue
class node_fourbit,node_lsm,node_project1,node_project2 toneAmber
class node_geartrain,node_gear toneMint
class node_media toneRose
class node_visitor toneIndigo
```

## Components

### Portfolio pages

- [Homepage](https://github.com/aadilsood014/engineering-portfolio/blob/main/app/page.tsx): `app/page.tsx`
- [About page](https://github.com/aadilsood014/engineering-portfolio/blob/main/app/About/page.tsx): `app/About/page.tsx`
- [Root layout](https://github.com/aadilsood014/engineering-portfolio/blob/main/app/layout.tsx): `app/layout.tsx`

### Project showcases

- [Four-bit adder](https://github.com/aadilsood014/engineering-portfolio/blob/main/app/projects/fourBit/page.tsx): `app/projects/fourBit/page.tsx`
- [LSM automation](https://github.com/aadilsood014/engineering-portfolio/blob/main/app/projects/lsm/page.tsx): `app/projects/lsm/page.tsx`
- [Sensor claw](https://github.com/aadilsood014/engineering-portfolio/blob/main/app/projects/project-1/page.tsx): `app/projects/project-1/page.tsx`
- [Robotics project](https://github.com/aadilsood014/engineering-portfolio/blob/main/app/projects/project-2/page.tsx): `app/projects/project-2/page.tsx`

### Animated decoration

- [Gear train](https://github.com/aadilsood014/engineering-portfolio/blob/main/app/components/GearTrain.tsx): `app/components/GearTrain.tsx`
- [Gear shape](https://github.com/aadilsood014/engineering-portfolio/blob/main/app/components/Gear.tsx): `app/components/Gear.tsx`

### Public media

- [Static media](https://github.com/aadilsood014/engineering-portfolio/tree/main/public): `public`

### Other components

- **Portfolio visitor**

## Connections

- Portfolio visitor → Homepage: opens
- Homepage → About page: links to (evidence: `app/page.tsx`)
- Homepage → Four-bit adder: links to (evidence: `app/page.tsx`)
- Homepage → LSM automation: links to (evidence: `app/page.tsx`)
- About page → Homepage: links to (evidence: `app/About/page.tsx`)
- Four-bit adder → Homepage: links to (evidence: `app/projects/fourBit/page.tsx`)
- Sensor claw → Homepage: links to (evidence: `app/projects/project-1/page.tsx`)
- Robotics project → Homepage: links to (evidence: `app/projects/project-2/page.tsx`)
- Root layout → Gear train: renders (evidence: `app/layout.tsx`)
- Gear train → Gear shape: renders (evidence: `app/components/GearTrain.tsx`)
- About page → Static media: displays (evidence: `app/About/page.tsx`)
- Four-bit adder → Static media: displays (evidence: `app/projects/fourBit/page.tsx`)
