Raj
Home/Projects/rvedire.com

rvedire.com

live

Personal portfolio and project showcase site

1 progress reportsView Source ↗
ETLResearchEngineeringModelingLaunch
Next.js 16React 19TypeScript 5Tailwind CSS 4Geist font familyMDX (next-mdx-remote 6.0)gray-matternext-themes
Overview

What It Is

The personal portfolio website for Raj Vedire, showcasing professional projects, work experience, technical skills, learning notes, and real-time GitHub contribution activity. Built as a content-driven static site with file-based content management and no database dependency.


Architecture

A Next.js App Router application with file-based content:

  • Pages: Home (hero, experience timeline, tech stack marquee, featured projects, hobbies), projects listing and detail pages, technical notes, ideas collection, and a "now" page.
  • Content System: All content stored as MDX files with YAML frontmatter in a /content directory. Nine content types: articles, notes, projects, ideas, now, about, contact, experience, and techstack. Parsed by gray-matter at build time.
  • GitHub Integration: Server-side scraping of GitHub contribution data (daily counts, monthly and yearly totals) with ISR revalidation every hour.
  • Rendering: Static site generation via generateStaticParams for all content pages. MDX rendering with custom styled components for headings, links, code blocks, and blockquotes.
Key Features

Data Sources

  • File System: MDX files in /content with YAML frontmatter.
  • GitHub: Contribution data scraped server-side from the GitHub contributions page with 10-second timeout and ISR caching.

Current State

Live and actively maintained on Vercel. Recent work includes content updates, style refinements, layout restructuring (V2 design), MDX migration to next-mdx-remote 6.0, and Geist font family integration. The site serves as the central hub for all project overviews and progress reports.

Progress Reports
Report #0 of 1
rvedire.com: First Report, Full Implementation Audit
Jul 6, 2026

Devlog

This is the first progress report for the website itself, which is ironic for the project that hosts everyone else's progress reports. The site has been live through a v3.1 design system rebrand (deep teal, two fonts, a 5-stage pipeline bar), a native resume page with five client islands, an interactive diagram system, and a Key Features drawer, and none of it was ever written up. Today I ran a full implementation audit to close that gap.

The audit checked three things: whether projects and reports were current, whether the design system was implemented to spec, and whether anything spec'd was missing or half-built. The code came out clean: 18 of 19 design checks passed, all custom CSS is correctly layered for Tailwind 4, and the one "violation" turned out to be a stale design doc still showing the old research color. The content told a different story. Every active project was at least 73 days behind on reports, the /now page was five months out of date, and the /about route was still serving scaffold text with example.com links. The site's code had quietly outrun its own documentation.

The most useful finding was structural: the project registry used shorthand slugs that matched neither the content folders nor the frontmatter, which meant milestone tracking could not reliably map to actual files. I reconciled all fourteen entries to canonical slugs, added two projects that had published reports but no registry entry, and recorded the open loops each project's last report left dangling. I also confirmed the GitHub contributions heatmap exists as a finished component with a working data layer but is rendered nowhere, which is a five-line fix waiting for a decision on placement.

What's next: Commit the pending work (AgenticWorkflows showcase, knowledge base, six project reports), then write catch-up reports for the live projects with the oldest gaps: CoverDrive Cricket, HL-SWA, and the XI Selector.

Changelog

Added

  • Add AgenticWorkflows landing section: tabs through 4 agentic projects with agent cards and flow nodes
  • Add docs/knowledge-base/ with 10 consolidated project documentation modules
  • Add docs/implementation-audit-2026-07-06.md covering report staleness, spec gaps, and doc drift
  • Add /now link to the header navigation
  • Add ball-view and open-export entries to PROJECT_REGISTRY.md
  • Add first rvedire-web progress report (this file)

Changed

  • Update PROJECT_REGISTRY.md to canonical slugs matching content folders and frontmatter (8 mismatches reconciled)
  • Update docs/design-system-v3.1.html research stage color to the current #E5A832
  • Update /now page and content/now/status.mdx to reflect July 2026 state
  • Update CLAUDE.md pages and components sections to match what actually renders

Fixed

  • Fix /about route serving template scaffold text with placeholder example.com links
nextjstailwindmdxdocumentationaudit