
Portfolio Site
Solo Developer
Portfolio
Next.js
TypeScript
Performance
Developer Tools
Next.js 16
React 18
TypeScript
TailwindCSS
Framer Motion
Zustand
Radix UI
shadcn/ui
Next Themes
CMDK
Sonner
Built entirely in 24 hours, this portfolio site demonstrates rapid full-stack development with modern web technologies. The site features a persistent audio player with waveform visualization, developer-focused tools including an inspector overlay and mini terminal, a VS Code-style command palette, responsive design across all breakpoints, and smooth animations throughout. Every component is production-ready, fully typed, and optimized for performance.
Overview
This portfolio site was conceived, designed, and built from scratch in a single 24-hour sprint. The goal was to create a production-ready showcase that demonstrates not just design skills, but deep technical capabilities — including complex state management, real-time features, developer tools, and modern React patterns. The site serves as both a portfolio and a technical demonstration, featuring advanced features like a persistent audio player, component inspector, command palette, and fully responsive layouts.
Architecture
• Next.js 16 App Router with TypeScript for type-safe, server-rendered pages
• React Server Components for optimal performance and SEO
• Zustand for lightweight, performant state management:
• UI store (theme, panels, dialogs, inspect mode)
• Player store (queue, playback state, position)
• Persistent storage via Zustand middleware
• Framer Motion for smooth animations and scroll-based effects:
• Scroll-triggered parallax effects
• Page transitions
• Component entrance animations
• Carousel transitions
• Radix UI + shadcn/ui for accessible, customizable components
• Custom cursor system with context-aware states
• Component inspector overlay using DOM traversal and data attributes
• Command palette (CMDK) with keyboard navigation
• Mini terminal with command execution and FAQ system
• Persistent audio player with HTML5 Audio API
• Waveform visualizer (placeholder for future Web Audio API integration)
• Theme system with light/dark/studio modes via next-themes
• Responsive design with mobile-first approach
• Optimized images with Next.js Image component
• Font optimization with next/font (DM Mono, Inter)
UI/UX
• Modern, minimal design language with consistent spacing and typography
• Fully responsive layouts that elegantly scale from mobile to desktop
• Smooth animations and transitions throughout
• Custom cursor with context-aware states (link, tap, text)
• Persistent audio player that survives navigation
• VS Code-inspired editor navigation panel
• Command palette (⌘K / Ctrl+K) for quick navigation
• Developer tools (inspector overlay, mini terminal) for technical demonstration
• Theme panel with live preview
• Settings sheet for customization
• Contact dialog with form handling
• Smooth scroll animations and parallax effects
• Carousel components with fade transitions
• Hover effects and micro-interactions
• Mobile hamburger menu with full navigation
• Accessible components with proper ARIA labels
Challenges & Solutions
Challenges:
• Building a complete, production-ready site in 24 hours
• Implementing persistent audio player that survives Next.js navigation
• Creating component inspector that accurately identifies React components
• Building command palette with complex routing and action handling
• Managing multiple overlapping UI states (panels, dialogs, modals)
• Implementing smooth animations without performance degradation
• Creating responsive layouts that maintain design integrity
• Handling theme persistence across page reloads
• Optimizing bundle size while including many features
• TypeScript type safety across complex state management
• Ensuring accessibility while maintaining modern UX
• Mobile navigation UX that doesn't compromise desktop experience
Solutions:
• Leveraged Next.js App Router for optimal performance and SEO
• Used Zustand for simple, performant state management
• Implemented data-component and data-file attributes for component identification
• Built modular component architecture for reusability
• Used Framer Motion for GPU-accelerated animations
• Implemented mobile-first responsive design patterns
• Used next-themes for seamless theme persistence
• Optimized images and fonts for fast loading
• Implemented proper TypeScript types throughout
• Used Radix UI for accessible, unstyled primitives
• Created consistent design system with TailwindCSS
• Tested across multiple devices and browsers
Impact
• Delivered a fully functional, production-ready portfolio in 24 hours
• Demonstrated rapid development capabilities with modern tech stack
• Showcased advanced features including:
• Persistent audio player
• Developer tools (inspector, terminal)
• Command palette navigation
• Responsive design
• Smooth animations
• Created a technical showcase that demonstrates:
• Full-stack capabilities
• Modern React/Next.js expertise
• UI/UX design skills
• Performance optimization
• TypeScript proficiency
• Built a maintainable codebase with:
• Clear component structure
• Type-safe state management
• Reusable UI components
• Consistent design patterns
• Established foundation for future enhancements:
• Blog system
• Portfolio case studies
• Lab experiments
• Additional interactive features
