Colophon
How this site is built — the tech and the decisions behind it.
Built with
- Astro Content-first static site framework
- Tailwind CSS Utility-first styling
- TypeScript Type safety
- MDX Components inside Markdown
- Expressive Code Code blocks (with Twoslash)
- Pagefind Client-side full-text search
- Mermaid Diagrams from text
- GitHub Pages Hosting (via GitHub Actions)
Decisions
- Static-first: everything is rendered at build time, so the site is fast and cheap to host.
- Bilingual by design: every page exists in Turkish and English with proper hreflang.
- No heavy frameworks on the client — just a small vanilla script for interactions.
- Dark/light theme and a live accent-color picker, persisted in localStorage.
- Accessibility: skip links, focus styles, reduced-motion support and semantic markup.
The full source is on GitHub.