8000 GitHub - bvmites/portfolio · GitHub
[go: up one dir, main page]

Skip to content
bvmitesPublic

Repository files navigation

Bhavyank K. Vithalani: Senior DevOps / SRE Portfolio

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.

Project structure

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

1. Run it locally

You need Node.js 20 or newer.

npm install
npm run dev        # http://localhost:3000

Production check (this is exactly what gets hosted):

npm run build      # creates the static site in ./out
npm run start      # serves ./out locally

2. Things to fill in first

Open 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).

3. Push to GitHub

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 main

4. Best free hosting: Vercel (recommended)

Vercel is made by the Next.js team, is free for personal projects, builds on every push and gives you HTTPS automatically.

  1. Sign in at vercel.com with your GitHub account.
  2. Click Add New → Project and import your repository.
  3. Leave every setting as detected (Framework: Next.js). Click Deploy.
  4. In about a minute you get a live URL like https://your-repo.vercel.app.
  5. Put that URL in siteUrl in src/data/site.ts, commit and push.

Alternative: Netlify

New site from Git → pick the repo → build command npm run build, publish directory out → Deploy.

Alternative: GitHub Pages

The site is a static export, so it works there too.

  1. Repo Settings → Pages → Source: GitHub Actions.
  2. 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.)

5. Connect a custom domain later

  1. Buy a domain from any registrar (Namecheap, GoDaddy, Cloudflare, Google Domains successors).
  2. Vercel: Project → Settings → Domains → Add. Vercel shows the exact DNS records.
  3. At your registrar add what Vercel shows, typically an A record 76.76.21.21 for the root domain and a CNAME for www pointing to cname.vercel-dns.com (use the exact values Vercel displays).
  4. Wait for DNS to propagate (minutes to a few hours). HTTPS is issued automatically.
  5. Update siteUrl in src/data/site.ts to the new domain.

6. Updating the portfolio later

Edit the relevant file in src/data/, then:

git add .
git commit -m "Add new project"
git push

Vercel (or Netlify / GitHub Pages) rebuilds and publishes automatically within a minute or two.

  • New project: copy an object in projects.ts, change the text, set flow (the architecture steps) and tags.
  • New job or achievement: edit experience.ts.
  • New skill: add it to a group in skills.ts.

7. Notes

  • 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 @config in src/app/globals.css).

Releases

Packages

Contributors

Languages

0