How steveruizok/personal-blog works
Main Components
A. Frontend Layer
• Next.js Pages (Static & Dynamic Routes)
• React Components
• MDX Content System
• Styling System (Stitches)
B. Build & Static Generation Layer
• Next.js Static Site Generation
• Content Generation System
• Asset Processing
C. Content Management Layer
• MDX Files
• Static Assets (images/videos)
• Content JSON
D. Infrastructure Layer
• Vercel Deployment
• API Routes
┌─ Client Layer ─────────────────────┐
• Browser │
• Client-side Navigation │
• Client-side React Hydration │
• ┬───────────────────┘
• ↓
┌─ Frontend Layer ───────────────────┐
• ┌─ Pages ─────┐ ┌─ Components ─┐ │
• _app.tsx │ │ - Layout │ │
• index.tsx │ │ - MDX │ │
• [slug].tsx│ │ - UI Elements│ │
• ┘ └─────────────┘ │
• ┌─ Hooks ─────┐ ┌─ Styles ────┐ │
• useGtag │ │ - Stitches │ │
• useScroll │ │ - Global CSS │ │
• ┘ └─────────────┘ │
• ┬───────────────────┘
• ↓
┌─ Build Layer ────────────────────┐
• Next.js Static Generation │
• Content Generation Script │
• MDX Processing │
• ┬─────────────────┘
• ↓
┌─ Content Layer ──────────────────┐
• ┌─ MDX ───────┐ ┌─ Assets ────┐ │
• Posts │ │ - Images │ │
• Pages │ │ - Videos │ │
• ┘ └────────────┘ │
• ┬─────────────────┘
• ↓
┌─ Infrastructure ────────────────┐
• Vercel Hosting │
• API Routes │
• CDN (Static Assets) │
• ┘
Important Relationships to Highlight
• How the content generation script (scripts/generate-content.ts) processes MDX files into content.json
• Relationship between pages and their corresponding MDX content
• Demonstrate how components are composed within the layout system
• Build-time vs. runtime processes
Additional Elements
• Annotations for key architectural decisions
• Development vs. production flow
• Where client-side interactivity occurs