Personal portfolio and blog, live at buddhsentripathi.com. Built with Next.js 16 (App Router), TypeScript, Tailwind v4, and an MDX-powered blog backed by Cloudflare R2 and Supabase. The focus is on performance, SEO, and a clean developer experience.

The previous iteration of the portfolio lives on the ver/04-26 branch.

• Home: Hero with bio, contribution graph, social links, hackathons feed, and CTA
• Projects: Project showcase with tech badges, GitHub stars, and live previews
• Blogs: Technical and personal articles with view counters, TOC, and tabbed navigation
• Experience: Timeline of professional work with responsibilities and stack
• Hackathons, Research, Newsletter: Dedicated pages for each

• MDX posts stored on Cloudflare R2 and rendered with next-mdx-remote
• Per-post view counter backed by Supabase with batched fetches
• Table of contents, reading time, and syntax highlighting via highlight.js
• RSS feed (/feed.xml) and dynamic sitemap (/sitemap.xml)

• Dark/Light Mode: Theme toggling via next-themes
• Newsletter: Email sign-ups backed by Supabase
• Visitor Counter: Tracks unique visitors
• SEO Optimized: Full JSON-LD (Person, Website, ProfilePage, BlogPosting, Breadcrumb) plus per-page OpenGraph, Twitter cards, and canonical URLs
• Analytics: Google Analytics integration
• Animations: Smooth transitions with Motion (ex-Framer Motion)

Follow these steps to get the project running locally:

1. Clone the repository:

   git clone https://github.com/buddhsen-tripathi/PortfolioWeb.git
   cd PortfolioWeb

2. Install dependencies:

   bun install

3. Personalize the site: Open src/site.config.ts and update identity, contact info, socials, SEO defaults, nav, and content lists. This is the single source of truth — see Customization below.

4. Set up Environment Variables: Copy .env.example to .env.local and fill in your credentials (see Environment Variables section below).

5. Run the development server:

   bun run dev

   Open http://localhost:3000 to view the site.

All site content and SEO flow from a single file: src/site.config.ts. Edit it once and every page, metadata tag, JSON-LD schema, RSS feed, and sitemap updates automatically.

Use the buildMetadata helper in src/lib/metadata.ts — it inherits all site defaults and lets you override per page:

// src/app/your-page/page.tsx
import { buildMetadata } from "@/lib/metadata";

export const metadata = buildMetadata({
  title: "Your Page",
  description: "What this page is about.",
  path: "/your-page",
});

This automatically fills in canonical URL, OpenGraph tags, Twitter card, site name, and the page-appropriate image.

Create a .env.local file with the following variables:

Supabase expects a views table (slug text primary key, count int) with an RPC increment_view_count(post_slug text), plus a newsletter_subscribers table (email text primary key).

src/
├── site.config.ts            # ⭐ Central config — edit this to customize
├── app/
│   ├── api/                  # API routes
│   │   ├── github/           # Contribution graph + star counts
│   │   ├── location/         # Visitor geolocation
│   │   ├── socials/          # Live social metrics
│   │   ├── subscribe/        # Newsletter subscription
│   │   ├── views/            # Blog view counter (single + batch)
│   │   └── visitors/         # Visitor tracking
│   ├── blogs/                # Blog list, [slug], MDX utilities
│   ├── experience/           # Experience page
│   ├── hackathons/           # Hackathons page
│   ├── research/             # Research page
│   ├── newsletter/           # Newsletter page
│   ├── projects/             # Projects listing
│   ├── feed.xml/             # RSS feed route
│   ├── sitemap.xml/          # Sitemap route
│   ├── layout.tsx            # Root layout (reads siteConfig)
│   ├── page.tsx              # Home page
│   └── globals.css           # Tailwind v4 theme + base styles
├── components/
│   ├── blog/                 # MDX components, view counter, TOC
│   ├── common/               # Shared (newsletter subscription, etc.)
│   ├── sections/             # Page sections (hero, projects, experience, etc.)
│   ├── layout/               # Layout wrappers and timeline
│   ├── ui/                   # shadcn/ui primitives
│   ├── icons/                # Icon components
│   └── illustrations/        # Custom SVG illustrations
├── constants/                # Re-exports content from site.config.ts
├── lib/
│   ├── metadata.ts           # buildMetadata() helper for per-page SEO
│   ├── jsonLd.ts             # JSON-LD schema generators (reads siteConfig)
│   ├── r2Client.ts           # Cloudflare R2 integration
│   ├── supabaseAdmin.ts      # Supabase server client
│   ├── github.ts             # GitHub API helpers
│   └── utils.ts              # Utility functions
├── utils/                    # Fonts and misc
└── public/                   # Static assets

• Website: buddhsentripathi.com
• LinkedIn: buddhsen-tripathi
• Twitter/X: @senbuilds

• Original template: ShivaBhattacharjee/Portfolio-latest

This project is open source under the MIT License.

• Next.js Documentation - Learn about Next.js features and API
• Tailwind CSS v4 - Utility-first CSS framework
• shadcn/ui - Re-usable UI components
• Supabase - Open source Firebase alternative
• Cloudflare R2 - Object storage

Built by Buddhsen Tripathi 💙