# piyushgarg-dev/piyushgargdev-nextjs architecture

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

- Interactive diagram: https://gitdiagram.com/piyushgarg-dev/piyushgargdev-nextjs
- Repository: https://github.com/piyushgarg-dev/piyushgargdev-nextjs

## Overview

This is a personal portfolio and developer-education site built with Next.js. Visitors browse the home page’s profile, YouTube, courses, testimonials, terminal, and contact sections; separate routes expose gear and project details, plus short-URL pages. Contact submissions reach an API route, while authentication uses a MongoDB adapter. The graph follows explicit imports and calls in the supplied excerpts and SOURCE INDEX; some listed UI modules or capabilities are not rendered in the sampled home-page JSX, so no runtime connections to them are inferred.

Main entry points: [`pages/index.js`](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/index.js) (Home page), [`components/Layout/Layout.jsx`](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/Layout/Layout.jsx) (Shared layout), [`components/UI/Courses.jsx`](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Courses.jsx) (Courses section), [`components/UI/Testimonial.jsx`](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Testimonial.jsx) (Testimonials section)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Site experience"]
  node_layout["Shared layout<br/>[Layout.jsx]"]
  node_header["Navigation and auth<br/>[Header.jsx]"]
  node_footer["Site footer<br/>[Footer.jsx]"]
  node_hero["Hero section<br/>[Hero.jsx]"]
  node_services["YouTube section<br/>[Services.jsx]"]
  node_serviceitem["YouTube stats item<br/>[ServicesItem.jsx]"]
  node_coursesui["Courses section<br/>[Courses.jsx]"]
  node_testimonials["Testimonials section<br/>[Testimonial.jsx]"]
  node_terminal["Interactive terminal<br/>[Terminal.jsx]"]
  node_contact["Contact section<br/>[Contact.jsx]"]
  node_form["Contact form<br/>[Form.jsx]"]
  node_subtitle["Section subtitle"]
end

subgraph group_content["Portfolio content"]
  node_portfolioitem["Portfolio card<br/>[PortfolioItem.jsx]"]
  node_blogui["Blog section<br/>[Blog.jsx]"]
  node_coursesdata["Course data<br/>[courses.js]"]
  node_geardata["Gear data<br/>[gears.js]"]
  node_projectsdata["Project data<br/>[projects.js]"]
  node_testdata["Testimonial data<br/>[testimonial.js]"]
  node_ytdefaults["YouTube fallbacks<br/>[youtubeDefault.js]"]
  node_urlsdata["Short URL data<br/>[urls.js]"]
end

subgraph group_routes["Pages and APIs"]
  node_home["Home page<br/>[index.js]"]
  node_app["App layout setup<br/>[_app.js]"]
  node_gearsroute["Gear listing<br/>[gears.js]"]
  node_projectroute["Project detail<br/>[&#91;slug&#93;.jsx]"]
  node_urlroute["Short URL page<br/>[&#91;slug&#93;.jsx]"]
  node_sitemap["Sitemap route<br/>[sitemap.xml.js]"]
  node_contactapi["Contact API<br/>[contact.js]"]
  node_authapi["Authentication API<br/>[&#91;...nextauth&#93;.js]"]
end

subgraph group_services["External services"]
  node_mongoadapter["MongoDB adapter<br/>[mongodbAdapter.js]"]
  node_youtube["YouTube API"]
  node_mongodb[("MongoDB")]
end

node_visitor(("Visitor"))

node_visitor -->|"visits"| node_home
node_app -->|"wraps pages"| node_layout
node_layout -->|"renders"| node_header
node_layout -->|"renders"| node_footer
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_services
node_home -->|"renders"| node_coursesui
node_home -->|"renders"| node_testimonials
node_home -->|"renders"| node_terminal
node_home -->|"renders"| node_contact
node_home -->|"loads"| node_coursesdata
node_home -->|"loads"| node_testdata
node_home -->|"uses fallback"| node_ytdefaults
node_home -->|"fetches channel data"| node_youtube
node_home -->|"fetches videos"| node_youtube
node_services -->|"renders"| node_serviceitem
node_coursesui -->|"renders"| node_subtitle
node_coursesui -->|"renders"| node_portfolioitem
node_testimonials -->|"renders"| node_subtitle
node_testimonials -->|"receives feedback"| node_home
node_contact -->|"imports"| node_form
node_contact -->|"posts message"| node_contactapi
node_contactapi -->|"accepts submission"| node_visitor
node_gearsroute -->|"loads"| node_geardata
node_gearsroute -->|"renders"| node_portfolioitem
node_projectroute -->|"loads"| node_projectsdata
node_sitemap -->|"reads"| node_projectsdata
node_urlroute -->|"loads"| node_urlsdata
node_authapi -->|"configures adapter"| node_mongoadapter
node_mongoadapter -->|"connects"| node_mongodb

click node_home "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/index.js"
click node_app "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/_app.js"
click node_layout "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/Layout/Layout.jsx"
click node_header "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/Header/Header.jsx"
click node_footer "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/Footer/Footer.jsx"
click node_hero "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Hero.jsx"
click node_services "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Services.jsx"
click node_serviceitem "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/ServicesItem.jsx"
click node_coursesui "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Courses.jsx"
click node_testimonials "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Testimonial.jsx"
click node_terminal "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Terminal.jsx"
click node_contact "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Contact.jsx"
click node_form "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Form.jsx"
click node_subtitle "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/SectionSubtitle.jsx"
click node_portfolioitem "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/PortfolioItem.jsx"
click node_blogui "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Blog.jsx"
click node_coursesdata "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/data/courses.js"
click node_geardata "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/data/gears.js"
click node_projectsdata "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/data/projects.js"
click node_testdata "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/data/testimonial.js"
click node_ytdefaults "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/data/youtubeDefault.js"
click node_urlsdata "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/data/urls.js"
click node_gearsroute "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/gears.js"
click node_projectroute "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/projects/%5Bslug%5D.jsx"
click node_urlroute "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/url/%5Bslug%5D.jsx"
click node_sitemap "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/sitemap.xml.js"
click node_contactapi "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/api/contact.js"
click node_authapi "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/api/auth/%5B...nextauth%5D.js"
click node_mongoadapter "https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/lib/mongodbAdapter.js"

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_layout,node_header,node_footer,node_hero,node_services,node_serviceitem,node_coursesui,node_testimonials,node_terminal,node_contact,node_form,node_subtitle toneBlue
class node_portfolioitem,node_blogui,node_coursesdata,node_geardata,node_projectsdata,node_testdata,node_ytdefaults,node_urlsdata toneAmber
class node_home,node_app,node_gearsroute,node_projectroute,node_urlroute,node_sitemap,node_contactapi,node_authapi toneMint
class node_mongoadapter,node_youtube,node_mongodb toneRose
class node_visitor toneIndigo
```

## Components

### Site experience

- [Shared layout](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/Layout/Layout.jsx): `components/Layout/Layout.jsx`
- [Navigation and auth](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/Header/Header.jsx): `components/Header/Header.jsx`
- [Site footer](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/Footer/Footer.jsx): `components/Footer/Footer.jsx`
- [Hero section](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Hero.jsx): `components/UI/Hero.jsx`
- [YouTube section](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Services.jsx): `components/UI/Services.jsx`
- [YouTube stats item](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/ServicesItem.jsx): `components/UI/ServicesItem.jsx`
- [Courses section](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Courses.jsx): `components/UI/Courses.jsx`
- [Testimonials section](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Testimonial.jsx): `components/UI/Testimonial.jsx`
- [Interactive terminal](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Terminal.jsx): `components/UI/Terminal.jsx`
- [Contact section](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Contact.jsx): `components/UI/Contact.jsx`
- [Contact form](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Form.jsx): `components/UI/Form.jsx`
- [Section subtitle](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/SectionSubtitle.jsx): `components/UI/SectionSubtitle.jsx`

### Portfolio content

- [Portfolio card](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/PortfolioItem.jsx): `components/UI/PortfolioItem.jsx`
- [Blog section](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/UI/Blog.jsx): `components/UI/Blog.jsx`
- [Course data](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/data/courses.js): `components/data/courses.js`
- [Gear data](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/data/gears.js): `components/data/gears.js`
- [Project data](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/data/projects.js): `components/data/projects.js`
- [Testimonial data](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/data/testimonial.js): `components/data/testimonial.js`
- [YouTube fallbacks](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/data/youtubeDefault.js): `components/data/youtubeDefault.js`
- [Short URL data](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/components/data/urls.js): `components/data/urls.js`

### Pages and APIs

- [Home page](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/index.js): `pages/index.js`
- [App layout setup](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/_app.js): `pages/_app.js`
- [Gear listing](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/gears.js): `pages/gears.js`
- [Project detail](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/projects/%5Bslug%5D.jsx): `pages/projects/[slug].jsx`
- [Short URL page](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/url/%5Bslug%5D.jsx): `pages/url/[slug].jsx`
- [Sitemap route](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/sitemap.xml.js): `pages/sitemap.xml.js`
- [Contact API](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/api/contact.js): `pages/api/contact.js`
- [Authentication API](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/pages/api/auth/%5B...nextauth%5D.js): `pages/api/auth/[...nextauth].js`

### External services

- [MongoDB adapter](https://github.com/piyushgarg-dev/piyushgargdev-nextjs/blob/main/lib/mongodbAdapter.js): `lib/mongodbAdapter.js`
- **YouTube API**
- **MongoDB**

### Other components

- **Visitor**

## Connections

- Visitor → Home page: visits (evidence: `pages/index.js`)
- App layout setup → Shared layout: wraps pages (evidence: `pages/_app.js`)
- Shared layout → Navigation and auth: renders (evidence: `components/Layout/Layout.jsx`)
- Shared layout → Site footer: renders (evidence: `components/Layout/Layout.jsx`)
- Home page → Hero section: renders (evidence: `pages/index.js`)
- Home page → YouTube section: renders (evidence: `pages/index.js`)
- Home page → Courses section: renders (evidence: `pages/index.js`)
- Home page → Testimonials section: renders (evidence: `pages/index.js`)
- Home page → Interactive terminal: renders (evidence: `pages/index.js`)
- Home page → Contact section: renders (evidence: `pages/index.js`)
- Home page → Course data: loads (evidence: `pages/index.js`)
- Home page → Testimonial data: loads (evidence: `pages/index.js`)
- Home page → YouTube fallbacks: uses fallback (evidence: `pages/index.js`)
- Home page → YouTube API: fetches channel data (evidence: `pages/index.js`)
- Home page → YouTube API: fetches videos (evidence: `pages/index.js`)
- YouTube section → YouTube stats item: renders (evidence: `components/UI/Services.jsx`)
- Courses section → Section subtitle: renders (evidence: `components/UI/Courses.jsx`)
- Courses section → Portfolio card: renders (evidence: `components/UI/Courses.jsx`)
- Testimonials section → Section subtitle: renders (evidence: `components/UI/Testimonial.jsx`)
- Testimonials section → Home page: receives feedback (evidence: `pages/index.js`)
- Contact section → Contact form: imports (evidence: `components/UI/Contact.jsx`)
- Contact section → Contact API: posts message (evidence: `components/UI/Contact.jsx`)
- Contact API → Visitor: accepts submission
- Gear listing → Gear data: loads (evidence: `pages/gears.js`)
- Gear listing → Portfolio card: renders (evidence: `pages/gears.js`)
- Project detail → Project data: loads (evidence: `pages/projects/[slug].jsx`)
- Sitemap route → Project data: reads (evidence: `pages/sitemap.xml.js`)
- Short URL page → Short URL data: loads (evidence: `pages/url/[slug].jsx`)
- Authentication API → MongoDB adapter: configures adapter (evidence: `pages/api/auth/[...nextauth].js`)
- MongoDB adapter → MongoDB: connects (evidence: `lib/mongodbAdapter.js`)
