Colophon
About This Site
This site is a personal tech blog where I share notes, learnings, and write-ups about cloud architecture, AI/ML, and software engineering. It is designed to be fast, minimal, and accessible.
Tech Stack
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router) |
| Content | MDX via Velite |
| Styling | Tailwind CSS v4 |
| Language | TypeScript (strict mode) |
| Hosting | Vercel |
| Analytics | Vercel Analytics & Speed Insights |
Content Authoring
All posts and pages are written in MDX and stored in the repository alongside the code. Velite compiles MDX at build time into type-safe data that Next.js consumes as static content. This keeps the authoring workflow simple — just Markdown with optional JSX components.
Blog posts and TIL entries are available in both Japanese and English, maintained as parallel files rather than machine translations.
Design Principles
- Performance first — Static generation wherever possible, minimal client-side JavaScript
- Server Components by default — Client components only where interactivity is required
- No external CSS — All styling through Tailwind utility classes
- Dark mode support — System preference detection with manual toggle via next-themes
- Bilingual — Full Japanese/English support with custom i18n (no external library)
Development Tools
- Editor: Visual Studio Code, Kiro
- AI Assistant: Claude Code — used extensively for development and content creation
- Testing: Vitest (unit/component) + Playwright (E2E)
- Linting: ESLint + Prettier
- CI/CD: GitHub Actions → Vercel
Typography
Body text is rendered in the system font stack for fast loading and native feel. Code blocks use a monospace system font. The site uses a minimal color palette that adapts to light and dark modes.
Disclaimer
The views and opinions expressed on this site are my own and do not represent the official positions of my employer.
Source Code
The source code for this site is available on GitHub.