How alex289/portfolio works
Main System Components
a) Frontend Layer:
• Next.js Application (App Router)
• Internationalization System
• MDX Blog Content
• Authentication UI
• Command Palette
• Analytics
b) API Layer:
• Authentication Endpoints
• Guestbook API
• Now Playing (Spotify Integration)
• Views Counter
• OG Image Generation
• Feed Generation
c) Database Layer:
• Vercel Postgres
• Drizzle ORM
d) External Services:
• GitHub Integration
• Spotify API
• Authentication Providers (Google, GitHub)
┌─ Client Layer ─────────────────────┐
• Next.js Pages │
• React Components │
• TailwindCSS Styling │
• ┬───────────────────┘
• ↕
┌─ API Layer ────┴───────────────────┐
• Next.js API Routes │
• Authentication │
• External API Integration │
• ┬───────────────────┘
• ↕
┌─ Data Layer ───┴───────────────────┐
• Vercel Postgres │
• Drizzle ORM │
• ┬───────────────────┘
• ↕
┌─ External Services ─┴──────────────┐
• GitHub API │
• Spotify API │
• Auth Providers │
• ┘
Key Features to Highlight
a) Internationalization Flow:
• How messages/ directory connects to pages
• Locale routing structure
b) Content Management:
• MDX processing pipeline
• Blog post routing
• Image optimization
c) Authentication Flow:
• NextAuth.js integration
• Provider connections
• Protected routes
d) Data Flow:
• API route handling
• Database queries through Drizzle
• External API interactions
Implementation Details
• Authentication flow
• Content rendering pipeline
• API route handling
• Database schema
• Internationalization system
Remember to include:
• Error boundaries and error handling
• Build-time vs runtime processes
• Static vs dynamic routes
• Data fetching patterns
• State management flow
This will provide a comprehensive view of the system while maintaining clarity and usefulness for development and documentation purposes.