A fast, fully static portfolio built with Next.js 16, TypeScript, Tailwind CSS 4, React Three Fiber, Framer Motion and Lucide icons.
It has a 3D Kubernetes-style cluster in the hero, light/dark mode, a project filter, a contact form and a downloadable resume.
All content comes from your resume and lives in plain files under src/data/, so you never touch layout code to update it.
src/
app/ layout, page, SEO (robots, sitemap, favicon), global styles
components/ Hero, HeroScene (3D), About, Skills, Experience, Projects, Education, Contact, Navbar, Footer
data/ <-- edit your content here
site.ts name, links, hero stats, about text
skills.ts skill groups
experience.ts job, achievements, key engagements
projects.ts project cards (+ architecture flow)
education.ts education, certifications, learning
public/
Bhavyank_Vithalani_Resume.pdf <-- the "Download Resume" file
You need Node.js 20 or newer.
npm install
npm run dev # http://localhost:3000Production check (this is exactly what gets hosted):
npm run build # creates the static site in ./out
npm run start # serves ./out locallyOpen src/data/site.ts:
| Field | What to do |
|---|---|
github |
Paste your GitHub profile URL. The GitHub buttons stay hidden until you do. |
formspreeId |
Optional. Create a free form at formspree.io, paste the ID (the part after /f/). Empty means the contact form opens the visitor's email app. |
siteUrl |
Set to your live address after deploying (used for SEO and social previews). |
Open src/data/projects.ts: the six "personal build" cards contain only what your brief said, with no invented results. Add a repo link, real details and your own numbers to each.
Open src/data/education.ts: your resume lists no certifications, so none are shown. Add them to certifications (or topics to learning) and the cards appear automatically.
To replace the resume, overwrite public/Bhavyank_Vithalani_Resume.pdf (keep the file name, or update resumeFile in site.ts).
Create an empty repository on github.com (no README), then:
git init
git add .
git commit -m "Initial portfolio"
git branch -M main
git remote add origin https://github.com/<your-username>/<repo-name>.git
git push -u origin mainVercel is made by the Next.js team, is free for personal projects, builds on every push and gives you HTTPS automatically.
- Sign in at vercel.com with your GitHub account.
- Click Add New → Project and import your repository.
- Leave every setting as detected (Framework: Next.js). Click Deploy.
- In about a minute you get a live URL like
https://your-repo.vercel.app. - Put that URL in
siteUrlinsrc/data/site.ts, commit and push.
New site from Git → pick the repo → build command npm run build, publish directory out → Deploy.
The site is a static export, so it works there too.
- Repo Settings → Pages → Source: GitHub Actions.
- Add
.github/workflows/deploy.yml:
name: Deploy to GitHub Pages
on:
push:
branches: [main]
permissions:
contents: read
pages: write
id-token: write
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with: { node-version: 22, cache: npm }
- run: npm ci
- run: npm run build
env:
NEXT_PUBLIC_BASE_PATH: /${{ github.event.repository.name }}
- uses: actions/upload-pages-artifact@v3
with: { path: out }
deploy:
needs: build
runs-on: ubuntu-latest
environment: github-pages
steps:
- uses: actions/deploy-pages@v4(NEXT_PUBLIC_BASE_PATH is needed because project sites live at user.github.io/repo-name. Skip it if you name the repo <username>.github.io.)
- Buy a domain from any registrar (Namecheap, GoDaddy, Cloudflare, Google Domains successors).
- Vercel: Project → Settings → Domains → Add. Vercel shows the exact DNS records.
- At your registrar add what Vercel shows, typically an
Arecord76.76.21.21for the root domain and aCNAMEforwwwpointing tocname.vercel-dns.com(use the exact values Vercel displays). - Wait for DNS to propagate (minutes to a few hours). HTTPS is issued automatically.
- Update
siteUrlinsrc/data/site.tsto the new domain.
Edit the relevant file in src/data/, then:
git add .
git commit -m "Add new project"
git pushVercel (or Netlify / GitHub Pages) rebuilds and publishes automatically within a minute or two.
- New project: copy an object in
projects.ts, change the text, setflow(the architecture steps) andtags. - New job or achievement: edit
experience.ts. - New skill: add it to a group in
skills.ts.
- Costs nothing: no server, no database, no paid service. Vercel/Netlify/GitHub Pages free tiers are enough.
- Performance: the 3D scene loads only in the browser, pauses when scrolled off-screen or the tab is hidden, uses fewer objects on phones, and shows one still frame if the visitor prefers reduced motion. Without WebGL it falls back to a CSS glow.
- Accessibility: skip link, keyboard-friendly navigation, visible focus, labelled controls, semantic headings.
- Tailwind 4 is configured through
tailwind.config.ts(loaded by@configinsrc/app/globals.css).