A bilingual English and Persian portfolio and technical blog built for maximum SEO and performance on Kubernetes.
Role
Designer & Developer
Year
2026
Stack
TanStack Start · MDX · Kubernetes
Team
Solo
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.
A Persian translation is a single file
Canonical URLs, hreflang alternates, and the language toggle all update together
