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.
| Section | Directory | Entries |
|---|---|---|
| Blog | app/blog/data | 14 |
| Projects | app/projects/data | 28 |
| Hackathons | app/hackathons/data | 19 |
| Events | app/events/data | 9 |
| Work | app/work/data | 4 |
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:
generateRss.tswrites the RSS feed.generateIconData.tsbundles the icons the code uses.generateSearchIndex.tswritespublic/search-index.json.generateOgImage.tsxcreates the social preview image.next build --turbopackbuilds the pages.generateMarkdownPages.tswrites a Markdown copy of each content page intoout/.
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
| Area | Choice | Used for |
|---|---|---|
| Framework | Next.js 16, React 19 | App Router, server components, static export |
| Content | MDX, gray-matter, next-mdx-remote, remark-gfm | Pages from files |
| Styling | Tailwind CSS 4, shadcn/ui, Radix UI | Components and theming |
| Code blocks | rehype-starry-night | Syntax highlighting |
| Analytics | PostHog, Vercel Analytics, Speed Insights | Usage and performance data |
| Quality | Lighthouse CI, ESLint | Audits 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.