# nishirajsingh/portfolio architecture

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

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

## Overview

This is a personal portfolio site with a public profile and an admin-managed content area. Visitors enter through the home page, browse portfolio sections, and can reach the contact form; separate routes expose credentials, events, projects, experience, and coding-profile information. Administrators have dashboard pages and API routes for managing portfolio content. The sampled code confirms several page-to-component and API-to-storage links; some admin wiring and the DSA data flow were not shown, so those relationships are left out.

Main entry points: [`app/page.tsx`](https://github.com/nishirajsingh/portfolio/blob/main/app/page.tsx) (Home page), [`app/components/enhanced-navbar.tsx`](https://github.com/nishirajsingh/portfolio/blob/main/app/components/enhanced-navbar.tsx) (Site navigation), [`app/certifications/page.tsx`](https://github.com/nishirajsingh/portfolio/blob/main/app/certifications/page.tsx) (Credentials page), [`app/contact/page.tsx`](https://github.com/nishirajsingh/portfolio/blob/main/app/contact/page.tsx) (Contact page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public portfolio"]
  node_home["Home page<br/>[page.tsx]"]
  node_navigation["Site navigation"]
  node_theme["Theme state<br/>[theme-provider.tsx]"]
  node_footer["Site footer<br/>[footer.tsx]"]
end

subgraph group_content["Portfolio sections"]
  node_hero["Hero section<br/>[hero.tsx]"]
  node_about["About section<br/>[about.tsx]"]
  node_skills["Skills section<br/>[skills.tsx]"]
  node_projects["Projects page<br/>[page.tsx]"]
  node_experience["Experience page<br/>[page.tsx]"]
  node_events["Events page<br/>[page.tsx]"]
  node_certifications["Credentials page<br/>[page.tsx]"]
  node_profile["Coding profile<br/>[page.tsx]"]
  node_contact["Contact page<br/>[page.tsx]"]
  node_contact_component["Contact section<br/>[contact.tsx]"]
  node_contact_form["Contact form"]
end

subgraph group_admin["Admin management"]
  node_admin_dashboard["Admin dashboard<br/>[page.tsx]"]
  node_admin_projects["Project editor<br/>[page.tsx]"]
  node_admin_certifications["Credential editor<br/>[page.tsx]"]
  node_admin_events["Event editor<br/>[page.tsx]"]
  node_admin_upload["Image uploader<br/>[image-upload.tsx]"]
end

subgraph group_services["APIs and storage"]
  node_admin_auth["Admin authentication<br/>[route.ts]"]
  node_projects_api["Projects API<br/>[route.ts]"]
  node_certifications_api["Credentials API<br/>[route.ts]"]
  node_events_api["Events API<br/>[route.ts]"]
  node_upload_api["Upload API<br/>[route.ts]"]
  node_credly_api["Credly API<br/>[route.ts]"]
  node_dsa_api["DSA API<br/>[route.ts]"]
  node_auth["Session check<br/>[auth.ts]"]
  node_database[("JSON data store<br/>[db.ts]")]
end

subgraph group_integrations["External services"]
  node_web3forms["Web3Forms"]
  node_credly["Credly"]
end

node_visitor(("Visitor"))
node_admin_user(("Administrator"))

node_visitor -->|"opens"| node_home
node_home -->|"renders"| node_navigation
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_about
node_home -->|"renders"| node_skills
node_navigation -->|"uses"| node_theme
node_navigation -->|"links to"| node_projects
node_navigation -->|"links to"| node_experience
node_navigation -->|"links to"| node_profile
node_home -->|"links to"| node_projects
node_home -->|"links to"| node_experience
node_home -->|"links to"| node_events
node_home -->|"links to"| node_certifications
node_home -->|"links to"| node_contact
node_events -->|"renders"| node_navigation
node_events -->|"renders"| node_footer
node_contact -->|"renders"| node_navigation
node_contact -->|"renders"| node_contact_component
node_contact -->|"renders"| node_footer
node_contact_component -.->|"uses"| node_contact_form
node_contact_form -.->|"submits to"| node_web3forms
node_certifications -->|"renders"| node_navigation
node_certifications -->|"renders"| node_footer
node_certifications -->|"fetches"| node_certifications_api
node_certifications -->|"fetches"| node_credly_api
node_credly_api -.->|"retrieves badges"| node_credly
node_profile -->|"renders"| node_navigation
node_admin_user -.->|"opens"| node_admin_dashboard
node_admin_projects -.->|"manages projects"| node_projects_api
node_admin_certifications -.->|"manages credentials"| node_certifications_api
node_admin_events -.->|"manages events"| node_events_api
node_admin_upload -.->|"uploads images"| node_upload_api
node_projects_api -->|"checks session"| node_auth
node_projects_api -->|"reads and writes"| node_database
node_certifications_api -->|"checks session"| node_auth
node_certifications_api -->|"reads and writes"| node_database
node_events_api -->|"checks session"| node_auth
node_events_api -->|"reads and writes"| node_database
node_upload_api -->|"checks session"| node_auth

click node_home "https://github.com/nishirajsingh/portfolio/blob/main/app/page.tsx"
click node_navigation "https://github.com/nishirajsingh/portfolio/blob/main/app/components/enhanced-navbar.tsx"
click node_theme "https://github.com/nishirajsingh/portfolio/blob/main/app/components/theme-provider.tsx"
click node_hero "https://github.com/nishirajsingh/portfolio/blob/main/app/components/hero.tsx"
click node_about "https://github.com/nishirajsingh/portfolio/blob/main/app/components/about.tsx"
click node_skills "https://github.com/nishirajsingh/portfolio/blob/main/app/components/skills.tsx"
click node_projects "https://github.com/nishirajsingh/portfolio/blob/main/app/projects/page.tsx"
click node_experience "https://github.com/nishirajsingh/portfolio/blob/main/app/experience/page.tsx"
click node_events "https://github.com/nishirajsingh/portfolio/blob/main/app/events/page.tsx"
click node_certifications "https://github.com/nishirajsingh/portfolio/blob/main/app/certifications/page.tsx"
click node_profile "https://github.com/nishirajsingh/portfolio/blob/main/app/profile/page.tsx"
click node_contact "https://github.com/nishirajsingh/portfolio/blob/main/app/contact/page.tsx"
click node_contact_component "https://github.com/nishirajsingh/portfolio/blob/main/app/components/contact.tsx"
click node_contact_form "https://github.com/nishirajsingh/portfolio/blob/main/app/components/ui/enhanced-contact-form.tsx"
click node_footer "https://github.com/nishirajsingh/portfolio/blob/main/app/components/footer.tsx"
click node_admin_dashboard "https://github.com/nishirajsingh/portfolio/blob/main/app/admin/dashboard/page.tsx"
click node_admin_projects "https://github.com/nishirajsingh/portfolio/blob/main/app/admin/dashboard/projects/page.tsx"
click node_admin_certifications "https://github.com/nishirajsingh/portfolio/blob/main/app/admin/dashboard/certifications/page.tsx"
click node_admin_events "https://github.com/nishirajsingh/portfolio/blob/main/app/admin/dashboard/events/page.tsx"
click node_admin_upload "https://github.com/nishirajsingh/portfolio/blob/main/app/admin/dashboard/image-upload.tsx"
click node_admin_auth "https://github.com/nishirajsingh/portfolio/blob/main/app/api/admin/auth/route.ts"
click node_projects_api "https://github.com/nishirajsingh/portfolio/blob/main/app/api/admin/projects/route.ts"
click node_certifications_api "https://github.com/nishirajsingh/portfolio/blob/main/app/api/admin/certifications/route.ts"
click node_events_api "https://github.com/nishirajsingh/portfolio/blob/main/app/api/admin/events/route.ts"
click node_upload_api "https://github.com/nishirajsingh/portfolio/blob/main/app/api/admin/upload/route.ts"
click node_credly_api "https://github.com/nishirajsingh/portfolio/blob/main/app/api/credly/route.ts"
click node_dsa_api "https://github.com/nishirajsingh/portfolio/blob/main/app/api/dsa/route.ts"
click node_auth "https://github.com/nishirajsingh/portfolio/blob/main/lib/auth.ts"
click node_database "https://github.com/nishirajsingh/portfolio/blob/main/lib/db.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_home,node_navigation,node_theme,node_footer toneBlue
class node_hero,node_about,node_skills,node_projects,node_experience,node_events,node_certifications,node_profile,node_contact,node_contact_component,node_contact_form toneAmber
class node_admin_dashboard,node_admin_projects,node_admin_certifications,node_admin_events,node_admin_upload toneMint
class node_admin_auth,node_projects_api,node_certifications_api,node_events_api,node_upload_api,node_credly_api,node_dsa_api,node_auth,node_database toneRose
class node_web3forms,node_credly,node_visitor,node_admin_user toneIndigo
```

## Components

### Public portfolio

- [Home page](https://github.com/nishirajsingh/portfolio/blob/main/app/page.tsx): `app/page.tsx`
- [Site navigation](https://github.com/nishirajsingh/portfolio/blob/main/app/components/enhanced-navbar.tsx): `app/components/enhanced-navbar.tsx`
- [Theme state](https://github.com/nishirajsingh/portfolio/blob/main/app/components/theme-provider.tsx): `app/components/theme-provider.tsx`
- [Site footer](https://github.com/nishirajsingh/portfolio/blob/main/app/components/footer.tsx): `app/components/footer.tsx`

### Portfolio sections

- [Hero section](https://github.com/nishirajsingh/portfolio/blob/main/app/components/hero.tsx): `app/components/hero.tsx`
- [About section](https://github.com/nishirajsingh/portfolio/blob/main/app/components/about.tsx): `app/components/about.tsx`
- [Skills section](https://github.com/nishirajsingh/portfolio/blob/main/app/components/skills.tsx): `app/components/skills.tsx`
- [Projects page](https://github.com/nishirajsingh/portfolio/blob/main/app/projects/page.tsx): `app/projects/page.tsx`
- [Experience page](https://github.com/nishirajsingh/portfolio/blob/main/app/experience/page.tsx): `app/experience/page.tsx`
- [Events page](https://github.com/nishirajsingh/portfolio/blob/main/app/events/page.tsx): `app/events/page.tsx`
- [Credentials page](https://github.com/nishirajsingh/portfolio/blob/main/app/certifications/page.tsx): `app/certifications/page.tsx`
- [Coding profile](https://github.com/nishirajsingh/portfolio/blob/main/app/profile/page.tsx): `app/profile/page.tsx`
- [Contact page](https://github.com/nishirajsingh/portfolio/blob/main/app/contact/page.tsx): `app/contact/page.tsx`
- [Contact section](https://github.com/nishirajsingh/portfolio/blob/main/app/components/contact.tsx): `app/components/contact.tsx`
- [Contact form](https://github.com/nishirajsingh/portfolio/blob/main/app/components/ui/enhanced-contact-form.tsx): `app/components/ui/enhanced-contact-form.tsx`

### Admin management

- [Admin dashboard](https://github.com/nishirajsingh/portfolio/blob/main/app/admin/dashboard/page.tsx): `app/admin/dashboard/page.tsx`
- [Project editor](https://github.com/nishirajsingh/portfolio/blob/main/app/admin/dashboard/projects/page.tsx): `app/admin/dashboard/projects/page.tsx`
- [Credential editor](https://github.com/nishirajsingh/portfolio/blob/main/app/admin/dashboard/certifications/page.tsx): `app/admin/dashboard/certifications/page.tsx`
- [Event editor](https://github.com/nishirajsingh/portfolio/blob/main/app/admin/dashboard/events/page.tsx): `app/admin/dashboard/events/page.tsx`
- [Image uploader](https://github.com/nishirajsingh/portfolio/blob/main/app/admin/dashboard/image-upload.tsx): `app/admin/dashboard/image-upload.tsx`

### APIs and storage

- [Admin authentication](https://github.com/nishirajsingh/portfolio/blob/main/app/api/admin/auth/route.ts): `app/api/admin/auth/route.ts`
- [Projects API](https://github.com/nishirajsingh/portfolio/blob/main/app/api/admin/projects/route.ts): `app/api/admin/projects/route.ts`
- [Credentials API](https://github.com/nishirajsingh/portfolio/blob/main/app/api/admin/certifications/route.ts): `app/api/admin/certifications/route.ts`
- [Events API](https://github.com/nishirajsingh/portfolio/blob/main/app/api/admin/events/route.ts): `app/api/admin/events/route.ts`
- [Upload API](https://github.com/nishirajsingh/portfolio/blob/main/app/api/admin/upload/route.ts): `app/api/admin/upload/route.ts`
- [Credly API](https://github.com/nishirajsingh/portfolio/blob/main/app/api/credly/route.ts): `app/api/credly/route.ts`
- [DSA API](https://github.com/nishirajsingh/portfolio/blob/main/app/api/dsa/route.ts): `app/api/dsa/route.ts`
- [Session check](https://github.com/nishirajsingh/portfolio/blob/main/lib/auth.ts): `lib/auth.ts`
- [JSON data store](https://github.com/nishirajsingh/portfolio/blob/main/lib/db.ts): `lib/db.ts`

### External services

- **Web3Forms**
- **Credly**

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → Home page: opens (evidence: `app/page.tsx`)
- Home page → Site navigation: renders (evidence: `app/page.tsx`)
- Home page → Hero section: renders (evidence: `app/page.tsx`)
- Home page → About section: renders (evidence: `app/page.tsx`)
- Home page → Skills section: renders (evidence: `app/page.tsx`)
- Site navigation → Theme state: uses (evidence: `app/components/enhanced-navbar.tsx`)
- Site navigation → Projects page: links to (evidence: `app/components/enhanced-navbar.tsx`)
- Site navigation → Experience page: links to (evidence: `app/components/enhanced-navbar.tsx`)
- Site navigation → Coding profile: links to (evidence: `app/components/enhanced-navbar.tsx`)
- Home page → Projects page: links to (evidence: `app/page.tsx`)
- Home page → Experience page: links to (evidence: `app/page.tsx`)
- Home page → Events page: links to (evidence: `app/page.tsx`)
- Home page → Credentials page: links to (evidence: `app/page.tsx`)
- Home page → Contact page: links to (evidence: `app/page.tsx`)
- Events page → Site navigation: renders (evidence: `app/events/page.tsx`)
- Events page → Site footer: renders (evidence: `app/events/page.tsx`)
- Contact page → Site navigation: renders (evidence: `app/contact/page.tsx`)
- Contact page → Contact section: renders (evidence: `app/contact/page.tsx`)
- Contact page → Site footer: renders (evidence: `app/contact/page.tsx`)
- Contact section → Contact form: uses
- Contact form → Web3Forms: submits to
- Credentials page → Site navigation: renders (evidence: `app/certifications/page.tsx`)
- Credentials page → Site footer: renders (evidence: `app/certifications/page.tsx`)
- Credentials page → Credentials API: fetches (evidence: `app/certifications/page.tsx`)
- Credentials page → Credly API: fetches (evidence: `app/certifications/page.tsx`)
- Credly API → Credly: retrieves badges
- Coding profile → Site navigation: renders (evidence: `app/profile/page.tsx`)
- Administrator → Admin dashboard: opens
- Project editor → Projects API: manages projects
- Credential editor → Credentials API: manages credentials
- Event editor → Events API: manages events
- Image uploader → Upload API: uploads images
- Projects API → Session check: checks session (evidence: `app/api/admin/projects/route.ts`)
- Projects API → JSON data store: reads and writes (evidence: `app/api/admin/projects/route.ts`)
- Credentials API → Session check: checks session (evidence: `app/api/admin/certifications/route.ts`)
- Credentials API → JSON data store: reads and writes (evidence: `app/api/admin/certifications/route.ts`)
- Events API → Session check: checks session (evidence: `app/api/admin/events/route.ts`)
- Events API → JSON data store: reads and writes (evidence: `app/api/admin/events/route.ts`)
- Upload API → Session check: checks session (evidence: `app/api/admin/upload/route.ts`)
