Brock Penner's Portfolio
A modern, responsive portfolio website built with Next.js, showcasing my projects and skills as a junior developer. Features a clean design with automatic dark/light theme switching based on user preferences.
๐ Features
Responsive Design: Fully responsive layout that works on all device sizes
Automatic Theme Switching: Respects user's system theme preferences (light/dark mode)
Modern Tech Stack: Built with Next.js 15, React 19, and TypeScript
Static Export: Optimized for deployment on static hosting platforms
Semantic HTML: Accessible markup with proper ARIA labels
Performance Optimized: Image optimization and efficient bundling
Testing Setup: Configured with Vitest for unit testing
๐ Live Demo
Visit the live site: brocksportfolio.netlify.app
๐ ๏ธ Technologies Used
Frontend Framework: Next.js 15
UI Library: React 19
Language: TypeScript
Styling: Tailwind CSS 4
Font: Poppins (Google Fonts)
Testing: Vitest + Testing Library
Linting: ESLint
Deployment: Netlify (static export)
๐ Project Structure
๐ Getting Started
Prerequisites
Node.js 20.11.0 or higher
npm 10.0.0 or higher
Installation
Clone the repository
Install dependencies
Start the development server
Open your browser Navigate to http://localhost:3000
Available Scripts
npm run dev - Start development server with Turbopacknpm run build - Build the application for productionnpm start - Start production servernpm run lint - Run ESLintnpm test - Run tests with Vitestnpm run test:ui - Run tests with Vitest UI๐จ Design Features
Theme System
Automatic light/dark mode based on user's system preferences
CSS custom properties for consistent theming
Smooth transitions between theme states
Color Palette
Light Mode: Clean whites and grays with red accents
Dark Mode: Dark backgrounds with mint green highlights
Accent Colors: Carefully chosen for accessibility and visual appeal
Typography
Primary Font: Poppins for clean, modern readability
Responsive Text: Fluid typography that scales across devices
๐ฑ Components
Core Components
Navbar: Responsive navigation with mobile hamburger menu
ProjectCard: Reusable card component for project previews
EmailLink: Contact button with mailto functionality
ResumeLink: Resume download with PDF preview
Pages
Homepage: Hero section with introduction and skills overview
About: Personal background and interests
Projects: Gallery of development projects
Project Detail: Individual project pages with technologies, learnings, and links
๐ Deployment
This project is configured for deployment on Netlify with static export:
Automatic Deployment: Connected to GitHub for automatic deploys
Build Command:
npm run buildPublish Directory:
outNode Version: 20.11.0
Manual Deployment
๐งช Testing
The project includes a testing setup with Vitest:
Test files are located in
app/tests/ directory.๐ Performance
Lighthouse Score: Optimized for performance, accessibility, and SEO
Image Optimization: Next.js Image component for optimal loading
Static Export: Fast loading times with CDN distribution
Minimal Bundle: Efficient code splitting and tree shaking
๐ง Configuration
Environment Variables
No environment variables required for basic functionality.
Customization
Colors: Modify
tailwind.config.js and globals.cssContent: Update project data in
app/lib/projects.tsAssets: Replace images and icons in the
public/ directory๐ Adding New Projects
To add a new project:
Add project images to
public/images/Update project data in
app/lib/projects.ts:๐ค Contributing
This is a personal portfolio project, but feedback and suggestions are welcome! Feel free to:
Fork the repository
Create a feature branch
Submit a pull request
๐ Contact
Email: brockpenner@protonmail.com
LinkedIn: Brock Penner
Mastodon: @brockpenner@techhub.social
GitHub: orbithammer
๐ License
This project is open source and available under the MIT License.
Built with โค๏ธ by Brock Penner
0 likes ยท 7 views ยท Jun 2, 2025
Built a responsive portfolio website using Next.js, React, and TypeScript.