Home

Welcome to the beta-website repository — the personal website and multilingual content archive for Yuri Cunha. This static site is built with Astro, TypeScript, MDX, and Tailwind CSS, and is deployed to Vercel.

The site is intentionally small and fast. It has no React runtime, database, CMS, authentication, server functions, or visitor-side translation. All pages are pre-rendered at build time.

Project at a Glance

Aspect	Detail
Framework	Astro 7.x (static output)
Language	TypeScript 6.x (strict)
Styling	Tailwind CSS 4.x (CSS-first)
Content	Astro Content Collections (MDX)
i18n	Custom TS dictionaries (6 locales)
Locales	en, pt-br, ja, zh-cn, de, fr
Deployment	Vercel (static)
Package Manager	pnpm 11.8.0
Node	24.x
Production URL	https://breaking.yuricunha.com/

Wiki Pages

Page	Description
Setup	Quick start guide, prerequisites, and available commands.
Architecture	Deep dive into the tech stack, project structure, and routing.
Content Authoring	Guide to writing blog posts, snippets, and projects.
Internationalization	i18n architecture, translation workflows, and locale management.
Deployment	Vercel configuration, CI/CD, and performance monitoring.

Key Directories

src/
├── content/           # MDX content (blog, snippets, projects)
├── i18n/              # Translation dictionaries (6 locales)
├── components/        # Astro components
├── layouts/           # BaseLayout (HTML shell)
├── pages/             # File-based routing
├── lib/               # Utilities (routing, content, code-blocks)
└── styles/
    └── global.css     # Tailwind v4 + design tokens

Common Commands

Command	Purpose
pnpm dev	Dev server with HMR
pnpm build	Type-check + production build
pnpm preview	Preview dist/ locally
pnpm check	TypeScript + content validation
pnpm content:new:post	Scaffold blog post (6 locales)
pnpm content:new:snippet	Scaffold snippet (6 locales)
pnpm content:translate	Auto-translate missing content
pnpm content:check	Validate content consistency