DevLog

My minimalistic developer portfolio optimized for loading speed and SEO.

What it is

Dev Log is my developer portfolio, and it is the site you are reading. Built with Next.js and the shadcn/ui component library, it emphasizes loading speed and SEO (search engine optimization). It uses React Server Components (RSCs) to keep client-side JavaScript to a minimum. It also uses the Suspense API for asynchronous data.

The site lists projects, hackathons, events, work history and blog posts, plus a timeline that merges all of them.

How it works

Every page is generated from content files. Each entry is an MDX file with YAML frontmatter, stored in a data directory under its section.

SectionDirectoryEntries
Blogapp/blog/data14
Projectsapp/projects/data28
Hackathonsapp/hackathons/data19
Eventsapp/events/data9
Workapp/work/data4

Each section has a utils.ts that reads its directory and parses frontmatter with gray-matter. A dynamic route such as app/projects/[projectName]/page.tsx renders the body with next-mdx-remote and remark-gfm. The route also emits generateStaticParams, JSON-LD (structured data) and canonical metadata. A project links to its hackathon through the hackathonName frontmatter field.

next.config.ts sets output: "export", so next build writes a static site to out/. The build script runs generators before and after that step:

  1. generateRss.ts writes the RSS feed.
  2. generateIconData.ts bundles the icons the code uses.
  3. generateSearchIndex.ts writes public/search-index.json.
  4. generateOgImage.tsx creates the social preview image.
  5. next build --turbopack builds the pages.
  6. generateMarkdownPages.ts writes a Markdown copy of each content page into out/.

Design decisions

Static export. The repository moved to static export on 2024-11-07 (commit "make static exports"). Every page is pre-built, so no server renders pages at request time. The trade-off is that content changes need a rebuild. A commit the same day turned off image optimization (images: { unoptimized: true }).

Search index as a separate file. The command palette searches all content. Passing that data through server component props embedded it in every page. The script comment says each page then weighed 300-580 KB. The index is now one static JSON file that the browser fetches once and caches.

Only the icons in use. The full @iconify-json collections exceed 30 MB. generateIconData.ts scans the source for collection:name references and writes data for those icons only.

Content for agents and crawlers. The build writes .md copies of pages. Rules in vercel.json serve them when a request sends Accept: text/markdown. The site also ships llms.txt and a sitemap. Vercel's edge applies the rewrite, so serve out cannot test it locally. scripts/verifyAgentReadiness.ts checks the rest of the output.

Lighthouse budgets. lighthouserc.cjs audits 12 pages. A score below 0.9 for SEO fails the run. Accessibility and best practices below 0.9, or performance below 0.7, produce warnings.

Reference

AreaChoiceUsed for
FrameworkNext.js 16, React 19App Router, server components, static export
ContentMDX, gray-matter, next-mdx-remote, remark-gfmPages from files
StylingTailwind CSS 4, shadcn/ui, Radix UIComponents and theming
Code blocksrehype-starry-nightSyntax highlighting
AnalyticsPostHog, Vercel Analytics, Speed InsightsUsage and performance data
QualityLighthouse CI, ESLintAudits and linting

Outcome

  • The site is live at whyash5114.com.
  • The repository dates from 2022-05-29. The Next.js version started on 2024-10-17, and the latest commit at the time of writing is dated 2026-10-18.
  • The repository holds 284 commits.
  • The source repository is private, so this page links no repository.

Liked DevLog? Here's my background.

Full-stack TypeScript, shipped to real users.