HossinCode

HossinCode is a bilingual portfolio and technical blog. It renders MDX to static HTML at build time, highlights code with Shiki, and ships no client-side JavaScript on content routes.

#Problem

A personal site and blog has two requirements that usually fight each other: search engines must be able to crawl every page cleanly, and every piece of content must resolve to the correct alternate URL in the other language. Hand-wiring hreflang tags and retrofitting a right-to-left layout after the fact is error-prone and slow.

#Approach

Content lives in the repository as MDX folders, one file per language. The filesystem is the single source of truth: the presence of a file means the translation exists, and routing, the sitemap, and the language toggle all read from one function. Build-time tooling derives reading time, headings, and syntax highlighting so content routes ship no client JavaScript.

#Outcome

The result is a fast, crawler-friendly bilingual site that stays correct as content grows. Adding a Persian translation is a single file, and the site's canonical URLs, hreflang alternates, and language toggle all update together.