- MDX 88.7%
- Astro 5.7%
- TypeScript 5.4%
- CSS 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
isyuricunha
10ef54c2cb
- Astro 7.0.3 → 7.0.6, Tailwind 4.3.1 → 4.3.2 (architecture.md) - Add missing [section]/index.astro route to page tree and static routes table - Replace fictional vercel.json with actual security-headers-only content - Update production URL yuricunha.com → breaking.yuricunha.com everywhere - Fix broken doc links (ARCHITECTURE.md → architecture.md, etc.) |
||
| .github | ||
| docs | ||
| public | ||
| scripts | ||
| src | ||
| tests | ||
| .editorconfig | ||
| .env.example | ||
| .gitignore | ||
| .nvmrc | ||
| astro.config.ts | ||
| migration-report.json | ||
| package.json | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| README.md | ||
| TODO.md | ||
| tsconfig.json | ||
| vercel.json | ||
Yuri Cunha Personal Website
A static personal archive built with Astro, TypeScript, MDX, Astro Content Collections, Astro i18n routing, Tailwind CSS, Shiki, RSS, and Sitemap.
The site is intentionally small. It has no React runtime, database, CMS, authentication, server functions, or visitor-side translation.
Requirements
- Node.js 24
- pnpm 11.8
Development
pnpm install
pnpm dev
Run the full local validation:
pnpm check
pnpm test
pnpm build
Content
English is the source locale. Translations are ordinary MDX files stored beside the source:
src/content/blog/example/en.mdx
src/content/blog/example/pt-br.mdx
src/content/blog/example/ja.mdx
Create source files with:
pnpm content:new:post my-post
pnpm content:new:snippet useful-command
Validate frontmatter, locale filenames, translation links, dates, and missing translations:
pnpm content:check
STRICT_I18N=true pnpm content:check
Non-strict validation reports missing translations and exits successfully.
Strict validation fails when a published English entry is missing any of
pt-br, ja, zh-cn, de, or fr.
Translation Adapter
pnpm content:translate reports missing translations when no adapter is
configured. To generate files, configure an external local command:
CONTENT_TRANSLATION_COMMAND=/path/to/translator \
CONTENT_TRANSLATION_ARGS='["--format","mdx"]' \
pnpm content:translate
The command receives one JSON object on stdin:
{
"collection": "blog",
"slug": "example",
"sourceLocale": "en",
"targetLocale": "ja",
"sourcePath": "/absolute/path/en.mdx",
"sourceContent": "---\n..."
}
It must write a complete MDX document to stdout. Existing translations are never overwritten.
Deployment
Vercel detects Astro automatically and deploys the static dist output without
an adapter or serverless functions.
- Framework preset: Astro
- Install command:
pnpm install - Build command:
pnpm build - Output directory:
dist - Node.js:
24.x
The canonical production URL is https://breaking.yuricunha.com/.
Structure
src/components/ Astro UI and content components
src/content/ Grouped MDX source and translations
src/i18n/ Locale metadata and typed UI dictionaries
src/layouts/ Shared document layout
src/lib/ Content and route helpers
src/pages/ Static and generated routes
scripts/ Content authoring and validation tools
tests/ Node test runner suites
Implementation follows the official Astro documentation, Tailwind Astro guide, and Vercel Astro documentation.