maxwellbenton/maxwellbenton.github.io

โ˜… 2Forks 0TypeScriptGitHub โ†—Compare

README

Maxwell Benton - Portfolio Website

Personal portfolio showcasing my work as a Technical Lead and Front-End Engineer

๐ŸŒ Live Site: www.maxwellbenton.com

About

This is my personal portfolio website built with modern web technologies to showcase my experience as a Technical Lead and Front-End Engineer. The site features my recent projects, technical skills, and professional background.

๐Ÿ› ๏ธ Tech Stack

  • Front-End: React 18, TypeScript
  • Styling: Tailwind CSS
  • Build Tool: Vite
  • Deployment: GitHub Pages
  • CI/CD: GitHub Actions

๐Ÿš€ Features

  • Responsive Design - Optimized for desktop, tablet, and mobile
  • Performance Optimized - Fast loading with modern build tools
  • SEO Friendly - Proper meta tags and semantic HTML
  • Interactive Elements - Secret gnome easter egg for fun
  • Professional Content - Showcases real projects with quantified impact

๐Ÿ“ Project Structure

src/
โ”œโ”€โ”€ components/          # Reusable UI components
โ”‚   โ”œโ”€โ”€ Header/         # Navigation with social links
โ”‚   โ”œโ”€โ”€ Skills/         # Technical skills section
โ”‚   โ””โ”€โ”€ ...
โ”œโ”€โ”€ pages/              # Main page sections
โ”‚   โ”œโ”€โ”€ Experience/     # About and skills
โ”‚   โ”œโ”€โ”€ Projects/       # Portfolio projects
โ”‚   โ””โ”€โ”€ Main/          # Hero section
โ”œโ”€โ”€ constants/          # Shared constants and styling
โ”œโ”€โ”€ assets/            # Images and static files
โ””โ”€โ”€ types/             # TypeScript type definitions

๐Ÿƒโ€โ™‚๏ธ Getting Started

Prerequisites

  • Node.js (v18+)
  • npm or yarn

Installation

  1. Clone the repository

    git clone https://github.com/maxwellbenton/maxwellbenton.github.io.git
    cd maxwellbenton.github.io
  2. Install dependencies

    npm install
  3. Start development server

    npm run dev
  4. Open in browser

    http://localhost:5173
    

๐Ÿ”จ Available Scripts

Command Description
npm run dev Start development server
npm run build Build for production
npm run preview Preview production build locally
npm run lint Run ESLint
npm run deploy Deploy to GitHub Pages

๐Ÿ“ฆ Build & Deployment

The site is automatically built and deployed to GitHub Pages when changes are pushed to the gh-pages branch.

Manual deployment:

npm run build
npm run deploy

๐ŸŽจ Customization

Updating Content

  • Personal info: Edit src/constants.ts
  • Skills: Modify src/components/Skills/index.tsx
  • Projects: Update src/pages/Projects/index.tsx
  • Styling: Adjust src/constants/tailwind.ts

Adding New Projects

  1. Add project images to src/assets/
  2. Update the Projects component with new project data
  3. Include impact metrics and technical details

๐Ÿ”ง Configuration

Environment Setup

  • Node version: See .nvmrc (if applicable)
  • TypeScript: Strict mode enabled
  • ESLint: React and TypeScript rules
  • Vite: Modern bundling with SWC

Build Optimization

  • Code splitting - Automatic route-based splitting
  • Asset optimization - Images and fonts optimized
  • Bundle analysis - Use npm run build to see bundle size

๐Ÿ“Š Performance

  • Lighthouse Score: 90+ across all metrics
  • Bundle Size: ~157KB gzipped
  • Load Time: <2s on 3G networks

๐Ÿค Contributing

This is a personal portfolio, but if you spot any issues or have suggestions:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

๐Ÿ“ License

This project is open source and available under the MIT License.

๐Ÿ“ง Contact

Maxwell Benton


โญ Star this repo if you found it helpful or want to follow my work!

Contributors

maxwellbenton

Issues