Skip to content

mdasif-me/mdasif

Repository files navigation

Md. Asif - Portfolio & Personal Website

Welcome to my professional portfolio and personal website built with cutting-edge web technologies. This is a fully-featured, high-performance web application showcasing my expertise as a Frontend & Full-Stack Developer.

🎯 About

I'm Md. Asif, a Frontend & Full-Stack Software Engineer with 5+ years of experience specializing in:

  • React.js & Next.js - Building modern, performant web applications
  • TypeScript - Type-safe JavaScript development
  • Full-Stack Development - From UI to backend APIs
  • Web Performance - Optimizing for speed and user experience
  • UI/UX Development - Creating beautiful, accessible interfaces
  • REST & GraphQL APIs - Building and integrating APIs
  • AWS & DevOps - Cloud deployment and CI/CD pipelines

Portfolio Highlights

  • Website: muhammadasif.me
  • Expertise: Frontend Development, Full-Stack Solutions, Web Performance Optimization
  • Focus Areas: React, Next.js, TypeScript, Tailwind CSS, GSAP Animations, and Modern Web Standards

πŸš€ Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • pnpm (v9 or higher) - Used as the package manager

Installation

  1. Clone the repository:
git clone https://github.com/mdasif-me/mdasif.git
cd mdasif
  1. Install dependencies:
pnpm install
  1. Set up environment variables (if needed):
cp .env.example .env.local

Development

Run the development server with Turbopack for faster builds:

pnpm dev

Open http://localhost:3000 in your browser to see the result.

The application auto-updates as you edit files. Start by modifying src/app/page.tsx.

Production Build

pnpm build
pnpm start

Other Commands

  • Format Code: pnpm format - Formats code using Prettier
  • Lint: pnpm lint - Run ESLint to check code quality
  • Build Check: pnpm build:check - Run Prettier check and build

πŸ—οΈ Project Structure

src/
β”œβ”€β”€ app/              # Next.js App Router pages
β”‚   β”œβ”€β”€ layout.tsx    # Root layout with navigation, reviews, FAQ, and contact
β”‚   β”œβ”€β”€ page.tsx      # Home page
β”‚   β”œβ”€β”€ about/        # About page
β”‚   β”œβ”€β”€ contact/      # Contact page
β”‚   β”œβ”€β”€ projects/     # Projects portfolio
β”‚   └── services/     # Services page
β”œβ”€β”€ components/       # Reusable React components
β”‚   β”œβ”€β”€ ui/           # Base UI components (buttons, carousels, etc.)
β”‚   β”œβ”€β”€ navigation/   # Navigation components
β”‚   └── constants/    # Component-related constants
β”œβ”€β”€ features/         # Feature-specific components and logic
β”‚   β”œβ”€β”€ about/        # About section components
β”‚   β”œβ”€β”€ contact/      # Contact form and social links
β”‚   β”œβ”€β”€ experiences/  # Work experience timeline
β”‚   β”œβ”€β”€ faq/          # FAQ section
β”‚   β”œβ”€β”€ home/         # Home page hero and sections
β”‚   β”œβ”€β”€ projects/     # Projects showcase
β”‚   β”œβ”€β”€ reviews/      # Client reviews/testimonials
β”‚   └── services/     # Services showcase
β”œβ”€β”€ hooks/            # Custom React hooks
β”œβ”€β”€ lib/              # Utility functions
β”œβ”€β”€ styles/           # Global and module CSS
β”œβ”€β”€ types/            # TypeScript type definitions
└── utils/            # Helper utilities
config/               # Site configuration and metadata

πŸ› οΈ Tech Stack

Frontend

  • Next.js 16 - React framework with App Router
  • React 19 - UI library
  • TypeScript - Type safety
  • Tailwind CSS - Utility-first CSS framework
  • GSAP - Advanced animations
  • Motion - Framer Motion animations
  • Embla Carousel - Carousel component

Styling & UI

  • Tailwind CSS v4 - Modern utility CSS
  • PostCSS - CSS transformation
  • Radix UI - Headless UI components
  • CVA (Class Variance Authority) - Component variants

Development Tools

  • ESLint - Code linting
  • Prettier - Code formatting
  • Husky - Git hooks
  • Lint-staged - Stage file linting
  • TypeScript - Type checking

πŸ“± Features

  • ✨ Modern Design - Beautiful, responsive UI with smooth animations
  • ⚑ High Performance - Optimized with Turbopack for faster builds
  • πŸ” SEO Optimized - Comprehensive metadata and structured data
  • πŸ“± Responsive Design - Works seamlessly on all devices
  • β™Ώ Accessibility - Built with a11y best practices
  • 🎨 Smooth Animations - GSAP and Motion animations
  • πŸ“Š Sections Include:
    • Hero section with animated title
    • About/Bio section
    • Services showcase
    • Portfolio/Projects display
    • Work experiences timeline
    • Client reviews/testimonials
    • FAQ section
    • Contact form and social links

πŸ” SEO & Metadata

The site includes comprehensive SEO configuration:

  • Metadata for all pages (home, about, services, projects)
  • Open Graph tags for social sharing
  • Twitter Card integration
  • Structured data markup
  • Sitemap and robots.txt
  • Google and Bing site verification

🌐 Deployment

Vercel (Recommended)

The easiest way to deploy is using Vercel Platform from the Next.js creators:

  1. Push your code to GitHub
  2. Import the repository in Vercel
  3. Vercel will automatically detect Next.js and configure the build settings
  4. Your site will be live after deployment

For more details, check Next.js deployment documentation.

Other Platforms

You can also deploy to:

  • Netlify - Supports Next.js
  • AWS Amplify - Full AWS integration
  • Docker - Containerized deployment

πŸ“ Environment Variables

Create a .env.local file in the root directory:

NEXT_PUBLIC_CONTACT_EMAIL=your-email@example.com
NEXT_PUBLIC_CONTACT_PHONE=+1234567890

πŸš€ Performance Optimizations

  • Image Optimization - Automatic WebP/AVIF format conversion
  • Code Splitting - Automatic route-based splitting
  • CSS Optimization - Tailwind CSS purging unused styles
  • Font Optimization - Using next/font for Google Fonts
  • Caching - Strategic HTTP caching headers
  • Security Headers - CSP, X-Frame-Options, etc.

🀝 Contributing

This is a personal portfolio project. While contributions are not expected, feedback and suggestions are always welcome!

πŸ“ž Contact

πŸ“„ License

This project is licensed under the MIT License. See the LICENSE file for details.

πŸ™ Acknowledgments

  • Next.js - The React framework for production
  • Tailwind CSS - For utility-first CSS
  • GSAP - For professional animations
  • Vercel - For deployment platform
  • All open-source libraries and communities that made this possible

Built with ❀️ by Md. Asif