Bilingual site with blog and case studies
I wanted a single place where a recruiter, a colleague or a student could
read how I think and how I build. Code in the repo, case studies in MDX,
longer essays in /research, and a technical blog for short pieces. The
goal was not the prettiest portfolio on the block, it was one that works as
honest technical evidence.
Before this site I had a public Notion with links to deploys and a Webflow version I dragged around for two years. Same problems every portfolio has: content written the last time I updated my CV, pages that did not communicate how I build, and a technical visitor could spend 30 seconds and learn nothing concrete.
What I needed: a site that was direct access to my decisions. Public repo with commits that read well, MDX so I can write the why without fighting a CMS, and a layout that respects the reader's time.
Next.js App Router for server components. MDX so I can write content as files in the repo without touching a CMS. next-intl for paritary ES/EN support.
The most loaded call here is Velite. I evaluated Contentlayer, which is basically the standard for technical portfolios on Next, but it has been archived since late 2023. Velite replaces it with better DX, automatic types via Zod, and native MDX support on Tailwind v4.
Real trade-offs:
/public/static with hashed names. No paid SaaS.Source Serif 4 for headings and, on research pages, for the body too. It is the screen-optimized serif that gets closest to LaTeX's Computer Modern without asking the reader to tolerate 80s kerning.
Figtree for site chrome (navbar, footer, listings). It is a neutral sans that holds up at 14px. Geist Mono for metadata, status badges, and code.
Three families total. Within the typical budget for an editorial site (no more than 3).
@vercel/og./research with full paper mode.