danieldcs.com

Personal website of Daniel Castro. Static-first Next.js app, hosted on Vercel.

Stack

• Next.js 16 (App Router) and React 19
• TypeScript (strict)
• Tailwind CSS v4
• Biome (lint and format)
• MDX loaded from content/ in lib/content (gray-matter, Zod, next-mdx-remote)
• Vitest and Testing Library
• Playwright (chromium, mobile, and webkit)
• Vercel

Getting started

Requires pnpm 11.5.2 and Node.js 24 (.nvmrc and engines.node 24.x).

pnpm install
cp .env.example .env
pnpm dev

Environment variables are optional; the site runs locally without them. NEXT_PUBLIC_POSTHOG_KEY enables analytics only in Production (NEXT_PUBLIC_VERCEL_ENV=production); see the gate in lib/analytics.ts. The PostHog host is fixed in code. Privacy limits and the event list live in docs/analytics.md.

Scripts

• pnpm dev — Next.js development server
• pnpm build — production build
• pnpm start — serve the production build
• pnpm test — unit tests (Vitest)
• pnpm test:e2e — Playwright. Untagged tests run in chromium (Desktop Chrome). @mobile runs in mobile (Pixel 7). @smoke runs in webkit (Desktop Safari).
• pnpm lint — Biome check
• pnpm format — Biome check and write
• pnpm typecheck — tsc --noEmit

Install Chromium and WebKit once before the first local E2E run. CI uses the Playwright image, which already includes the browsers, and does not install them:

pnpm exec playwright install chromium webkit
pnpm test:e2e
pnpm test:e2e -- --project=mobile
pnpm test:e2e -- --project=webkit

pnpm test:e2e builds and starts the app (pnpm build && pnpm start) via Playwright's webServer.

Project structure

• app/ — Next.js App Router (routes, layouts, and styles)
• content/ — source content (posts/, community/), loaded by lib/content
• public/ — static files, including media/ for posts, personal photos, icons, illustrations, and documents
• lib/ — shared TypeScript modules
• components/ — UI by responsibility: views/ (pages), layout/ (shell, header, footer, container), mdx/ (MDX blocks), ui/ (controls and icons). Providers and route infra stay at the root (theme-provider, interface-language-provider, json-ld, route-error-boundary).
• e2e/ — Playwright tests (chromium, @mobile, @smoke)

@/foo resolves to <repo>/foo via compilerOptions.paths in tsconfig.json. Example: @/lib/site → lib/site.ts. There is no ~/* alias.

Branching

Trunk-based: feature branch → pull request → main → Vercel. Direct pushes, force-pushes, and deleting main are blocked. The GitHub Actions check ci must be green before merge. Reviews are not required in V1 (solo project).