Skip to content
Serafin Sanchez
Developer Portfolio with Next.js 14, MDX, and shadcn/ui preview

Developer Portfolio with Next.js 14, MDX, and shadcn/ui

A modern, responsive developer portfolio built with Next.js 14, featuring MDX content management, dark mode, and a clean design system.

React
Next.js
TypeScript
Tailwind CSS
MDX

Project Overview

This is my professional portfolio. I wanted to provide a clean, modern, and responsive user experience while maintaining easy content management through MDX files.

Key Features

โšก Modern Next.js Architecture

  • Next.js 14 with App Router for optimal performance and SEO
  • Server-side rendering and static generation for fast page loads
  • Dynamic imports and code splitting for efficient bundle sizes
  • TypeScript throughout for type safety and better developer experience

๐Ÿ“ MDX Content Management

  • Structured content with consistent frontmatter schemas
  • Dynamic routing for projects, blog posts, and work experiences
  • Type-safe content with TypeScript interfaces
  • Easy maintenance through simple markdown editing

๐ŸŽจ Design System & UI

  • Tailwind CSS for consistent, utility-first styling
  • shadcn/ui components for accessible, customizable interfaces
  • Dark mode support with system preference detection
  • Responsive design optimized for all device sizes
  • Custom animations using Framer Motion for enhanced UX

๐Ÿš€ Performance Optimized

  • Image optimization with Next.js Image component

  • Font optimization with Google Fonts integration

  • Bundle analysis and size optimization

Architecture & Technical Implementation

Frontend Architecture

  • Next.js 14 with App Router for modern React development
  • React Server Components for improved performance
  • TypeScript for type safety and enhanced development experience
  • Tailwind CSS for responsive, maintainable styling

Content Management

  • MDX files for structured content with frontmatter metadata
  • Dynamic imports for efficient content loading
  • Type-safe schemas for consistent project and work data
  • Automated content discovery through file system routing

State Management

  • React Context for theme management
  • Local storage persistence for user preferences
  • URL state for navigation and filtering
  • Form state with controlled components

Performance Optimization

  • Static generation for fast initial loads
  • Image optimization with responsive images and lazy loading
  • Code splitting at route and component levels
  • Bundle optimization with webpack analysis

Technical Challenges Overcome

Content Architecture

  • Consistent schemas across different content types (projects, work, blog)
  • Type safety for MDX frontmatter with TypeScript interfaces
  • Dynamic routing with proper error handling and 404 pages
  • SEO optimization with proper meta tags and structured data

Design Implementation

  • Design system creation with consistent spacing, colors, and typography
  • Dark mode implementation with smooth transitions and preference persistence
  • Responsive design across all device sizes and orientations
  • Accessibility compliance with WCAG guidelines

Performance Excellence

  • Bundle optimization through careful import analysis and code splitting
  • Image optimization with Next.js Image and proper sizing
  • Font loading optimization to prevent layout shifts
  • Caching strategies for optimal repeat visit performance

UI/UX Details

Modern React Interface

  • Clean typography with carefully chosen font pairings
  • Consistent spacing using Tailwind's design tokens
  • Smooth animations for page transitions and interactive elements
  • Loading states for better perceived performance

Responsive Design

  • Mobile-first approach with progressive enhancement
  • Flexible layouts using CSS Grid and Flexbox
  • Breakpoint optimization for tablets and desktop views
  • Touch-friendly interactions for mobile users

Accessibility Features

  • ARIA labels and semantic HTML throughout
  • Keyboard navigation support for all interactive elements
  • Color contrast compliance for readability
  • Screen reader optimization with proper heading structure

This portfolio was a fun project. I wanted to create something that looked great for visitors but was also easy for me to maintain and update.

Related Projects

Other projects you might find interesting

A sophisticated post-purchase feedback collection system with embeddable widgets for e-commerce integration, featuring real-time data collection, photo uploads, and seamless BigCommerce embedding.
Next.js
InstantDB
Embeddable Widgets
+2
A directory website to connect people with specialized cleaners in their area, featuring business search, ratings, and a responsive, accessible UI.
Next.js 14
React
TypeScript
+2
A zero-friction, real-time polling platform that lets teachers create engaging polls in seconds and get instant feedback from students.
Next.js
React
InstantDB
+2