How jeet6421/my-portfolio works
Project Type and Purpose
• This is a full-stack web application built with Next.js (React) – specifically a personal portfolio/resume site.
• It uses server-side rendering (SSR) or static site generation (SSG) for pages in the app/ directory, and serves static assets (PDF resume, images) from public/ and assets/public/.
File Structure Analysis
• app/
– components/ (React UI components: About, Contact, Header, Footer, Navbar, Projects, Resume)
– globals.css (global Tailwind styles)
– layout.js (application shell with common layout)
– page.js (root page entrypoint)
• assets/
– assets.js (dynamic imports of images/assets)
– public/ (raw assets like sample-resume.pdf)
• public/ (static hosting root – jitendrachoudharyfullstackresume.pdf)
• Configuration & Build
– next.config.mjs (Next.js config)
– tailwind.config.mjs & postcss.config.mjs (Tailwind CSS pipeline)
– eslint.config.mjs
– jsconfig.json
– package.json / package-lock.json
Key Architectural Patterns & Design Principles
• Component-based UI (React)
• File-system routing (Next.js “app” router)
• Separation of concerns:
• Presentation (app/components)
• Layout & routing (layout.js / page.js)
• Static assets (public/ & assets/)
• CSS utility framework (Tailwind via PostCSS)
• Optimized font loading with next/font
Main Components
A. Client Browser
B. Next.js Serverless Runtime (Vercel or Node.js)
C. Routing & Rendering Layer
• “app” router – page.js & layout.js
• React Components (app/components/*.jsx)
D. Static Assets Layer
• public/ (PDFs, images)
• assets/public/ (sample PDF)
E. Build & Deployment Pipeline
• npm / pnpm scripts (dev, build, start)
• Tailwind & PostCSS
• next.config.mjs
• CI/CD (Vercel)
F. External Services
• next/font CDN (Geist font from Vercel)
Relationships & Data Flow
1. Browser → HTTP GET / or /about → Next.js Server
2. Routing Layer resolves route from app/page.js or app/components/*
3. React components render HTML (SSR/SSG)
4. CSS pipeline applies Tailwind classes via global.css + postcss
5. Font assets loaded from next/font CDN
6. Static asset requests (/sample-resume.pdf) served directly from public/ or assets/public/
7. Build step bundles JS/CSS and deploys via Vercel