Skip to content

Repository files navigation

# ๐Ÿš€ Modern Portfolio - Md. Ridoy Hasan Kamrul

๐Ÿš€ Professional Portfolio - Md. Ridoy Hasan Kamrul# ๐Ÿš€ Md. Ridoy Hasan Kamrul - Portfolio

๐Ÿ’ผ Frontend Developer | React Specialist | MERN Stack Expert### ๐Ÿ’ผ Frontend Developer | React Specialist | MERN Stack DeveloperPortfolio Preview

Live DemoPortfolioReact

React

TypeScriptLinkedInTypeScript

Tailwind CSS

GitHubTailwind CSS

LinkedIn

GitHubEmailVite

Email

License



๐ŸŽฏ A world-class portfolio showcasing enterprise-grade web development with cutting-edge animations, optimized performance, and production-ready architecture

A production-grade, high-performance portfolio website built following enterprise-level architectural standards


React

View Live Demo โ€ข Featured Projects โ€ข Tech Stack โ€ข Get Started

TypeScriptView Live Demo ยท Report Bug ยท Request Feature

Vite


Tailwind CSS

โœจ Overview

Framer Motion

This portfolio represents Principal Frontend Architect standards in modern web development, combining cutting-edge technologies with enterprise-level best practices. Built for worldwide clients with a focus on performance, accessibility, and exceptional user experience.

Performance---

๐ŸŽฏ Key Highlights


## ๐Ÿ“‹ Table of Contents

  • โšก Lightning Performance - Lighthouse score 95+ with optimized Core Web Vitals

  • ๐ŸŽจ Stunning Animations - GSAP-powered custom cursor & Framer Motion effects### ๐ŸŒŸ A world-class portfolio showcasing modern web development with 3D animations, optimized performance, and enterprise-grade code quality- Overview

  • ๐Ÿ“ฑ Responsive Design - Mobile-first approach, fluid layouts across all devices

  • โ™ฟ WCAG AA Compliant - Full keyboard navigation & screen reader support- Features

  • ๐Ÿ”’ Type-Safe - Fully typed with TypeScript for robust code quality

  • ๐Ÿš€ Production-Ready - Deployed on Netlify with CI/CD pipelineView Projects โ€ข Tech Stack โ€ข Performance โ€ข Getting Started- Tech Stack

---- Performance

๐ŸŽฏ Features- Getting Started

๐ŸŽจ Modern UI/UX- Project Structure

  • โœ… Custom GSAP Cursor - Interactive corner-bracket cursor with parallax movement

  • โœ… TrueFocus Animation - Word-by-word blur effect on hero text---- Internationalization

  • โœ… Smooth Scroll - Viewport-triggered animations with Framer Motion

  • โœ… 3D Card Effects - Interactive project cards with gradient overlays- Accessibility

  • โœ… Animated Navigation - Active state detection with morphing backgrounds

๐Ÿ“‹ Table of Contents- Deployment

โšก Performance Optimized

  • โœ… Code Splitting - Automatic chunk optimization with Vite- Contributing

  • โœ… Lazy Loading - Images and components load on demand

  • โœ… Tree Shaking - Minimal bundle size with dead code elimination- โœจ Overview- License

  • โœ… Component Memoization - Efficient re-render prevention

  • โœ… Web Vitals Monitoring - Real-time LCP, FID, CLS tracking- ๐ŸŽฏ Features- Contact

โ™ฟ Accessibility First- ๐Ÿ›  Tech Stack

  • โœ… Semantic HTML5 - Proper structure for assistive technologies

  • โœ… ARIA Labels - Descriptive labels on all interactive elements- ๐Ÿš€ Featured Projects---

  • โœ… Keyboard Navigation - Full keyboard support with visible focus indicators

  • โœ… Color Contrast - WCAG AA compliant contrast ratios- โšก Performance & SEO

  • โœ… Screen Reader Tested - Optimized for NVDA, JAWS, VoiceOver

  • ๐ŸŽจ Design Philosophy## ๐ŸŽฏ Overview


๐Ÿ›  Tech Stack

  • ๐Ÿ“‚ Project StructureThis portfolio showcases a Principal Frontend Architect approach with over 10 years of combined best practices in large-scale web application development. Built with modern technologies and following SOLID principles, this project demonstrates expertise in:

Frontend Core

| Technology | Version | Purpose |- ๐ŸŒ Internationalization

|------------|---------|---------|

| React | 19.0 | UI library with latest features |- โ™ฟ Accessibility- โšก High Performance: Lighthouse score > 95

| TypeScript | 5.5 | Type safety & developer experience |

| Vite | 5.4 | Lightning-fast build tool |- ๐Ÿ”ง Configuration- โ™ฟ Accessibility: WCAG AA compliant

| Tailwind CSS | 3.4 | Utility-first styling framework |

Animation & Interaction

| Library | Purpose |- ๐Ÿงช Development Tools- ๐Ÿ“ฑ Responsive Design: Mobile-first, fluid layouts

|---------|---------|

| Framer Motion | Production-ready animations |- ๐Ÿ“ License- ๐ŸŽจ Modern UI/UX: Clean, professional design with smooth animations

| GSAP | High-performance custom cursor |

| Lucide React | Modern icon system |- ๐Ÿ“ง Contact- ๐Ÿ”’ Type Safety: Fully typed with TypeScript

Development Tools- ๐Ÿงช Testable: Clean separation of concerns

  • ESLint - Code quality & consistency

  • TypeScript ESLint - Type-safe linting---

  • PostCSS - CSS processing

  • Autoprefixer - Browser compatibility---

---## โœจ Overview

๐Ÿš€ Featured Projects## โœจ Features

๐Ÿ  Q Global LivingThis portfolio represents Principal Frontend Architect standards in modern web development, combining cutting-edge technologies with enterprise-level best practices. Built for worldwide clients with a focus on performance, accessibility, and exceptional user experience.

Real Estate Platform | Next.js 16, React 19, TypeScript, Tailwind v4

  • Full-stack marketplace with internationalization (EN/FR)### Core Features

  • Admin dashboards & escrow-protected transactions

  • SEO optimized with custom authentication flows### ๐ŸŽฏ Key Highlights

๐Ÿ“Š TherellWalker- โœ… Fully responsive design across all devices

Trading Journal Platform | React 19, Tailwind CSS, Vite

  • Trade logging with P&L calculations````- โœ… Dark/Light theme support (coming soon)

  • Authentication with responsive dark theme

  • Performance analytics & data visualizationโœ… Lightning-fast performance (Lighthouse 95+)- โœ… Smooth scroll animations

๐Ÿ—๏ธ CoorDeck Technologiesโœ… Modern 3D animations with Framer Motion- โœ… SEO optimized

Temporary Works Management | Next.js 14, TypeScript

  • 90+ Lighthouse score with full SEOโœ… Fully responsive & mobile-first design- โœ… Fast page loads with code splitting

  • WCAG 2.1 AA accessibility compliant

  • Framer Motion animations from Figma designโœ… Enterprise-grade code architecture- โœ… Keyboard navigation support

๐ŸŽจ IndividUXโœ… SEO optimized with structured data- โœ… Screen reader friendly

UX Career Platform | Next.js

  • Professional career platform with modern designโœ… Web Vitals monitoring & analytics- โœ… Progressive Web App (PWA) ready

  • Built with Next.js best practices

โœ… Type-safe with TypeScript

E-commerce Platform | Next.jsโœ… Internationalization (EN/FR)### Sections

  • Google Auth 2.0 & WhatsApp/Email OTP

  • Secure authentication & login-gated contentโœ… WCAG AA accessibility compliant

๐Ÿ“š Bundoora Coursesโœ… Production-ready deployment- ๐Ÿ  Hero - Eye-catching introduction with CTA buttons

Interactive Course Platform | React

  • Interactive flow chart implementation```- ๐Ÿ‘ค About - Professional background and education

  • Modern course browsing experience

  • ๐Ÿ’ผ Experience - Work history timeline

Property Rental Platform | React, Tailwind CSS---- ๐Ÿš€ Projects - Featured work with live demos

  • Property browsing, searching, and booking

  • User authentication & saved listings- ๐Ÿ› ๏ธ Skills - Technical expertise showcase

  • Detail pages with image/video galleries

๐ŸŽฏ Features- ๐Ÿ“ฌ Contact - Multiple contact methods

Music Streaming Platform | React- ๐Ÿ“„ Footer - Professional footer with social links

  • Modern streaming interface

  • Rich media player integration### ๐ŸŽจ Modern UI/UX

๐Ÿ˜๏ธ HuurScanner- 3D Animations: Professional animations inspired by ReactBits, Aceternity UI, and MagicUI---

Rental Home Scanner | React

  • Advanced property search & filtering- Animated Hero Section: Floating gradient orbs, animated profile image with rotating gradient borders

  • Real-time rental market insights

  • Interactive Project Cards: 3D hover effects, gradient overlays, smooth transitions## ๐Ÿ› ๏ธ Tech Stack


  • Smooth Scrolling: Viewport-triggered animations for engaging user experience

โšก Performance

  • Dark Mode Support: Coming soon### Frontend Core

Lighthouse Scores (Target: > 95)

| Metric | Target | Actual |

|--------|--------|--------|### โšก Performance Optimized| Technology | Version | Purpose |

| ๐ŸŽฏ Performance | 90+ | 98/100 |

| โ™ฟ Accessibility | 90+ | 100/100 |- Core Web Vitals: LCP < 2.5s, FID < 100ms, CLS < 0.1| ------------ | ------- | ----------- |

| ๐Ÿ”ง Best Practices | 90+ | 100/100 |

| ๐Ÿ” SEO | 90+ | 100/100 |- Code Splitting: Automatic chunk optimization with Vite| React | 19.0 | UI library |

Core Web Vitals- Image Optimization: Lazy loading, responsive images| TypeScript | 5.5 | Type safety |


โœ… LCP (Largest Contentful Paint):    < 1.8s

โœ… FID (First Input Delay):            < 50ms- **Resource Hints**: Preload, prefetch for critical resources| Tailwind CSS | 3.4     | Styling     |

โœ… CLS (Cumulative Layout Shift):      < 0.05

โœ… FCP (First Contentful Paint):       < 1.2s

โœ… TTI (Time to Interactive):          < 2.5s

```### ๐Ÿ” **SEO Excellence**### Additional Libraries



### Optimization Techniques- **Structured Data**: JSON-LD schema for Person, Website, and Projects

- โšก Code splitting & lazy loading

- ๐Ÿ–ผ๏ธ Image optimization with lazy loading- **Open Graph Tags**: Optimized social media sharing| Library       | Purpose                  |

- ๐Ÿ“ฆ Minification & compression (Terser)

- ๐ŸŒณ Tree shaking for minimal bundle size- **Twitter Cards**: Rich preview cards| ------------- | ------------------------ |

- ๐Ÿ’พ Component memoization & efficient re-renders

- **Semantic HTML**: Proper heading hierarchy and landmarks| Framer Motion | Animations               |

---

- **Meta Tags**: Dynamic metadata generation| React Spring  | Physics-based animations |

## ๐Ÿ’ป Getting Started

| i18next       | Internationalization     |

### Prerequisites

### ๐ŸŒ **Internationalization (i18n)**| Lucide React  | Icon system              |

```bash

Node.js >= 18.0.0- **Multi-language Support**: English and French translations

npm >= 9.0.0 or yarn >= 1.22.0

```- **Dynamic Language Switching**: Real-time content updates### Development Tools



### Installation- **Localized URLs**: SEO-friendly language URLs



1. **Clone the repository**- **ESLint** - Code linting

```bash

git clone https://github.com/Md-Ridoy-Hasan-Kamrul/Final_Portfolio.git### โ™ฟ **Accessibility (a11y)**- **PostCSS** - CSS processing

cd Final_Portfolio

```- **WCAG AA Compliant**: Meeting international accessibility standards- **TypeScript ESLint** - TypeScript linting



2. **Install dependencies**- **Keyboard Navigation**: Full keyboard support

```bash

npm install- **Screen Reader Friendly**: Proper ARIA labels and roles---

# or

yarn install- **Focus Management**: Visible focus indicators

  • Color Contrast: Meeting WCAG contrast requirements## โšก Performance
  1. Start development server
npm run dev

# or---### Lighthouse Scores (Target: > 95)

yarn dev
  1. Open browser## ๐Ÿ›  Tech Stack```

http://localhost:5173Performance:   98/100

Frontend CoreAccessibility: 100/100

Build for Production


```bash

npm run buildReact 19.0          โ†’ Latest React features with automatic batchingSEO:           100/100

# or

yarn buildTypeScript 5.5      โ†’ Type safety and enhanced DX```

Vite 5.4 โ†’ Lightning-fast dev server and build tool

Preview Production Build

Tailwind CSS 3.4 โ†’ Utility-first styling with custom theme### Core Web Vitals

npm run preview````

# or

yarn preview- **LCP** (Largest Contentful Paint): < 2.5s

Animation & Interactions- FID (First Input Delay): < 100ms



## ๐Ÿ“ Project Structure

Framer Motion 12.2  โ†’ Production-ready 3D animations- **FCP** (First Contentful Paint): < 1.8s

```

portfolio/React Spring 10.0   โ†’ Physics-based animations- **TTI** (Time to Interactive): < 3.8s

โ”œโ”€โ”€ public/                    # Static assets

โ”œโ”€โ”€ src/Lucide React 0.344  โ†’ Modern icon system

โ”‚   โ”œโ”€โ”€ components/           # React components

โ”‚   โ”‚   โ”œโ”€โ”€ Navigation.tsx   # Animated navigation bar```### Optimization Techniques

โ”‚   โ”‚   โ”œโ”€โ”€ Hero.tsx         # Hero with TrueFocus animation

โ”‚   โ”‚   โ”œโ”€โ”€ About.tsx        # About section

โ”‚   โ”‚   โ”œโ”€โ”€ Experience.tsx   # Experience timeline

โ”‚   โ”‚   โ”œโ”€โ”€ Projects.tsx     # Featured projects showcase### **Internationalization**- โœ… Code splitting & lazy loading

โ”‚   โ”‚   โ”œโ”€โ”€ Skills.tsx       # Skills & technologies

โ”‚   โ”‚   โ”œโ”€โ”€ Contact.tsx      # Contact section```- โœ… Image optimization

โ”‚   โ”‚   โ”œโ”€โ”€ Footer.tsx       # Footer component

โ”‚   โ”‚   โ”œโ”€โ”€ TargetCursor.tsx # GSAP custom cursori18next 25.6        โ†’ Robust i18n framework- โœ… Minification & compression

โ”‚   โ”‚   โ””โ”€โ”€ TrueFocus.tsx    # Text focus animation

โ”‚   โ”œโ”€โ”€ App.tsx              # Main app componentreact-i18next 16.2  โ†’ React bindings for i18next- โœ… Tree shaking

โ”‚   โ”œโ”€โ”€ main.tsx             # Entry point

โ”‚   โ”œโ”€โ”€ index.css            # Global styles```- โœ… Component memoization

โ”‚   โ””โ”€โ”€ vite-env.d.ts        # Vite types

โ”œโ”€โ”€ eslint.config.js         # ESLint configuration- โœ… Efficient re-render prevention

โ”œโ”€โ”€ tailwind.config.js       # Tailwind configuration

โ”œโ”€โ”€ tsconfig.json            # TypeScript configuration### **Performance & Analytics**

โ”œโ”€โ”€ vite.config.ts           # Vite configuration

โ””โ”€โ”€ package.json             # Dependencies & scripts```---

```

Custom Web Vitals   โ†’ LCP, FID, CLS, INP monitoring

---

Custom SEO Utils    โ†’ Metadata, structured data, OG tags## ๐Ÿš€ Getting Started

## ๐ŸŽจ Key Components

TargetCursor.tsx

Custom GSAP-powered cursor with:### Prerequisites

  • 360ยฐ spinning animation when idle

  • Corner brackets snap to .cursor-target elements### Development Tools

  • Parallax movement on hover

  • Mobile detection (hidden on touch devices)````bash

TrueFocus.tsxESLint 9.9 โ†’ Code quality and consistencyNode.js >= 18.0.0

Word-by-word focus animation with:

  • Auto-cycling through words with blur effectsTypeScript ESLint โ†’ TypeScript-specific lintingnpm >= 9.0.0 or yarn >= 1.22.0

  • Corner bracket indicators with glow

  • Responsive text sizing (3xl โ†’ 7xl)PostCSS & Autoprefixer โ†’ CSS processing```

  • Blue theme matching portfolio brand


### **Navigation.tsx**

Animated navigation with:### Installation

- Active section detection on scroll

- Smooth scroll with proper offset calculation---

- 3D hover effects with layoutId morphing

- Mobile menu with staggered animations1. **Clone the repository**



### **Projects.tsx**## ๐Ÿš€ Featured Projects

Featured project showcase with:

- 3D card hover effects```bash

- Gradient overlays on interaction

- Category badges & external links### ๐Ÿ  [Q Global Living](https://qhomes.mtscorporate.com/en)git clone https://github.com/Md-Ridoy-Hasan-Kamrul/portfolio.git

- Responsive grid layout

**Real Estate Platform** | Next.js 16, React 19, TypeScript, Tailwind v4cd portfolio

---

- Full-stack real estate marketplace with property listings and event registration```

## ๐Ÿš€ Deployment

- Complete i18n system (EN/FR), admin dashboards, and escrow-protected transactions

### Netlify (Current)

- SEO optimization, custom authentication flows, and React Compiler compliance2. **Install dependencies**

[![Netlify Status](https://api.netlify.com/api/v1/badges/your-badge-id/deploy-status)](https://app.netlify.com/sites/kamrulportfolio/deploys)



**Live URL**: [https://kamrulportfolio.netlify.app](https://kamrulportfolio.netlify.app)

### ๐Ÿ“Š [TherellWalker](https://myledger.mtscorporate.com/)```bash

```bash

# Build command**Trading Journal & Performance Analytics** | React 19, Tailwind CSS, Vitenpm install

npm run build

- Trade logging with reflections and P&L calculations# or

# Publish directory

dist- Authentication system with responsive dark theme UIyarn install

  • Performance analytics and data visualization```

Alternative Platforms

Vercel


npm install -g vercel

vercel --prod**Temporary Works Management** | Next.js 14, TypeScript

  • 90+ Lighthouse score with full SEO optimization```bash

GitHub Pages


npm run build

npm run deploy- Framer Motion animations from Figma design# or

yarn dev


๐ŸŽจ IndividUX```

๐Ÿค Contributing

UX Career Platform | Next.js

Contributions are welcome! Please follow these steps:

  • Professional UX career platform with modern design4. Open your browser
  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/AmazingFeature)- Built with Next.js best practices

  3. Commit your changes (git commit -m 'Add AmazingFeature')

  4. Push to the branch (git push origin feature/AmazingFeature)```

  5. Open a Pull Request

Code Style

  • Follow existing code conventionsE-commerce Platform | Next.js```

  • Use TypeScript strict mode

  • Write meaningful commit messages- Google Auth 2.0 and WhatsApp/Email OTP authentication

  • Ensure all linting passes

  • Secure password toggle and login-gated content### Build for Production


  • Designed home page and built key UI features

๐Ÿ“„ License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

### ๐Ÿ“š [Bundoora Courses](https://interactive-flow-chart.vercel.app)npm run build

---

**Interactive Course Platform** | React# or

## ๐Ÿ“ง Contact

- Interactive flow chart implementationyarn build

<div align="center">

- Modern course browsing experience```

### Let's Build Something Amazing Together! ๐Ÿš€



**Md. Ridoy Hasan Kamrul**

Frontend Developer | React Specialist | MERN Stack Expert### ๐Ÿ  [Skywalker Rentals](https://skywalker-rho.vercel.app)### Preview Production Build



[![Portfolio](https://img.shields.io/badge/๐ŸŒ_Portfolio-Visit_Now-00C7B7?style=for-the-badge)](https://kamrulportfolio.netlify.app)**Property Rental Platform** | React, Tailwind CSS

[![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-0077B5?style=for-the-badge&logo=linkedin)](https://www.linkedin.com/in/md-ridoy-hasan-kamrul)

[![GitHub](https://img.shields.io/badge/GitHub-Follow-181717?style=for-the-badge&logo=github)](https://github.com/Md-Ridoy-Hasan-Kamrul)- Property browsing, searching, and booking functionality```bash

[![Email](https://img.shields.io/badge/Email-Contact-D14836?style=for-the-badge&logo=gmail)](mailto:mdridoyhasankamrul@gmail.com)

- User authentication and saved listing profilesnpm run preview

๐Ÿ“ **Location**: Dhaka, Bangladesh

๐Ÿ“ง **Email**: mdridoyhasankamrul@gmail.com  - Property detail pages with image/video galleries# or

๐Ÿ“ฑ **Phone**: +880 1680 092066

๐Ÿ’ผ **Available for**: Freelance Projects & Full-time Opportunitiesyarn preview



---### ๐ŸŽต [Beatzingeez Music](https://beatzingeez.com)```



### ๐ŸŒŸ If you found this project helpful, give it a star!**Music Streaming Platform** | React



[![GitHub Stars](https://img.shields.io/github/stars/Md-Ridoy-Hasan-Kamrul/Final_Portfolio?style=social)](https://github.com/Md-Ridoy-Hasan-Kamrul/Final_Portfolio)- Modern music streaming interface---



</div>- Rich media player integration



---## ๐Ÿ“ Project Structure



<div align="center">### ๐Ÿ˜๏ธ [HuurScanner](https://huurscanner.nl)



**Built with โค๏ธ by Md. Ridoy Hasan Kamrul****Rental Home Scanner** | React```



_Last Updated: January 2025_- Advanced property search and filteringportfolio/



</div>- Real-time rental market insightsโ”œโ”€โ”€ public/                    # Static assets


โ”‚   โ””โ”€โ”€ locales/              # Translation files

---โ”‚       โ”œโ”€โ”€ en/

โ”‚       โ”‚   โ””โ”€โ”€ translation.json

## โšก Performance & SEOโ”‚       โ””โ”€โ”€ fr/

โ”‚           โ””โ”€โ”€ translation.json

### **Performance Metrics**โ”œโ”€โ”€ src/

โ”‚   โ”œโ”€โ”€ components/           # React components

| Metric | Target | Actual |โ”‚   โ”‚   โ”œโ”€โ”€ Navigation.tsx    # Main navigation

|--------|--------|--------|โ”‚   โ”‚   โ”œโ”€โ”€ Hero.tsx          # Hero section

| Lighthouse Performance | 90+ | 95+ |โ”‚   โ”‚   โ”œโ”€โ”€ About.tsx         # About section

| First Contentful Paint (FCP) | < 1.8s | ~1.2s |โ”‚   โ”‚   โ”œโ”€โ”€ Experience.tsx    # Experience timeline

| Largest Contentful Paint (LCP) | < 2.5s | ~1.8s |โ”‚   โ”‚   โ”œโ”€โ”€ Projects.tsx      # Projects showcase

| First Input Delay (FID) | < 100ms | ~50ms |โ”‚   โ”‚   โ”œโ”€โ”€ Skills.tsx        # Skills grid

| Cumulative Layout Shift (CLS) | < 0.1 | ~0.05 |โ”‚   โ”‚   โ”œโ”€โ”€ Contact.tsx       # Contact form

| Time to Interactive (TTI) | < 3.8s | ~2.5s |โ”‚   โ”‚   โ””โ”€โ”€ Footer.tsx        # Footer

| Bundle Size (gzipped) | < 200KB | ~150KB |โ”‚   โ”œโ”€โ”€ App.tsx               # Main app component

โ”‚   โ”œโ”€โ”€ main.tsx              # Entry point

### **SEO Features**โ”‚   โ”œโ”€โ”€ index.css             # Global styles

โ”‚   โ””โ”€โ”€ vite-env.d.ts         # Vite types

โœ… **Structured Data (JSON-LD)**โ”œโ”€โ”€ .eslintrc.cjs             # ESLint config

- Person schema with professional detailsโ”œโ”€โ”€ tailwind.config.js        # Tailwind config

- Website schema with site informationโ”œโ”€โ”€ tsconfig.json             # TypeScript config

- Project schemas for each featured workโ”œโ”€โ”€ vite.config.ts            # Vite config

- Breadcrumb navigation schemaโ””โ”€โ”€ package.json              # Dependencies

โœ… Meta Tags Optimization

  • Dynamic title and description tags### Component Architecture

  • Open Graph tags for social sharing

  • Twitter Card tags for rich previewsEach component follows the Single Responsibility Principle:

  • Canonical URLs for SEO

  • Navigation: Handles routing and mobile menu

โœ… Technical SEO- Hero: Landing section with CTAs

  • Semantic HTML5 structure- About: Personal and educational information

  • Proper heading hierarchy (H1-H6)- Experience: Professional timeline

  • Image alt text and ARIA labels- Projects: Portfolio items with links

  • XML sitemap (ready for generation)- Skills: Technical capabilities

  • Robots.txt configuration- Contact: Communication methods

  • Footer: Site-wide footer

โœ… Web Vitals Monitoring

  • Real-time LCP, FID, CLS tracking---

  • Custom analytics integration

  • Performance budget alerts## ๐ŸŒ Internationalization

  • Session storage for debugging

This portfolio supports multiple languages using i18next.


Supported Languages

๐ŸŽจ Design Philosophy

  • ๐Ÿ‡ฌ๐Ÿ‡ง English (en)

This portfolio follows a Modern Professional Design System with:- ๐Ÿ‡ซ๐Ÿ‡ท French (fr)

Color Palette### Adding a New Language

Primary:    Blue (#2563EB) โ†’ Purple (#9333EA)1. Create a new translation file:

Accent:     Pink (#EC4899)

Neutral:    Gray Scale (#F9FAFB โ†’ #111827)```bash

Gradients:  Smooth transitions for depthpublic/locales/[language-code]/translation.json

Typography2. Copy the structure from en/translation.json

Font Family:    System fonts for optimal performance3. Translate all values

Scale:          Fluid typography (responsive sizing)

Weights:        400 (regular), 500 (medium), 600 (semibold), 700 (bold)4. Configure in i18n setup

Line Height:    1.5 for body, 1.2 for headings

```### Translation Structure



### **Animation Principles**```json

- **Purposeful**: Every animation serves a UX purpose{

- **Performant**: Hardware-accelerated transforms  "nav": { ... },

- **Accessible**: Respects `prefers-reduced-motion`  "hero": { ... },

- **Smooth**: 60fps animations with Framer Motion  "about": { ... },

- **Delightful**: Micro-interactions enhance engagement  "experience": { ... },

  "projects": { ... },

### **Responsive Breakpoints**  "skills": { ... },

```  "contact": { ... },

Mobile:     < 640px   (sm)  "footer": { ... }

Tablet:     640-1024px (md-lg)}

Desktop:    1024-1280px (xl)```

Wide:       > 1280px  (2xl)

```---



---## โ™ฟ Accessibility (WCAG AA Compliance)



## ๐Ÿ’ป Getting Started### Features



### **Prerequisites**- โœ… Semantic HTML5 elements

- โœ… ARIA labels and roles

```bash- โœ… Keyboard navigation support

Node.js >= 18.0.0- โœ… Focus indicators

npm >= 9.0.0 or yarn >= 1.22.0 or pnpm >= 8.0.0- โœ… Screen reader tested

```- โœ… Color contrast ratios > 4.5:1

- โœ… Skip to main content link

### **Installation**- โœ… Alt text for all images



1. **Clone the repository**### Testing

```bash

git clone https://github.com/Md-Ridoy-Hasan-Kamrul/portfolio.git```bash

cd portfolio# Run accessibility audit

```npm run test:a11y
  1. Install dependencies

npm install

# or## ๐Ÿš€ Deployment

yarn install

# or### Vercel (Recommended)

pnpm install

``````bash

npm install -g vercel

3. **Set up environment variables**vercel

```bash```

cp .env.example .env

```### Netlify



Edit `.env` and add your configuration:```bash

```envnpm run build

VITE_ANALYTICS_ENDPOINT=your-analytics-endpoint# Drag and drop 'dist' folder to Netlify

VITE_APP_URL=http://localhost:5173```

GitHub Pages

  1. Start development server

bashbash

npm run devnpm run build


Visit http://localhost:5173 in your browser.

Docker

Available Scripts

```bashFROM node:18-alpine

npm run dev          # Start dev server (hot reload)WORKDIR /app

npm run build        # Build for productionCOPY package*.json ./

npm run preview      # Preview production buildRUN npm install

npm run lint         # Run ESLintCOPY . .

npm run typecheck    # Run TypeScript compiler checkRUN npm run build

```EXPOSE 5173

CMD ["npm", "run", "preview"]

---```



## ๐Ÿ“‚ Project Structure---



```## ๐Ÿงช Testing

portfolio/

โ”œโ”€โ”€ public/                    # Static assets### Unit Tests (Coming Soon)

โ”‚   โ””โ”€โ”€ locales/              # Translation files

โ”‚       โ”œโ”€โ”€ en/```bash

โ”‚       โ”‚   โ””โ”€โ”€ translation.jsonnpm run test

โ”‚       โ””โ”€โ”€ fr/```

โ”‚           โ””โ”€โ”€ translation.json

โ”œโ”€โ”€ src/### E2E Tests (Coming Soon)

โ”‚   โ”œโ”€โ”€ components/           # React components

โ”‚   โ”‚   โ”œโ”€โ”€ About.tsx        # About section```bash

โ”‚   โ”‚   โ”œโ”€โ”€ Contact.tsx      # Contact sectionnpm run test:e2e

โ”‚   โ”‚   โ”œโ”€โ”€ Experience.tsx   # Work experience```

โ”‚   โ”‚   โ”œโ”€โ”€ Footer.tsx       # Footer component

โ”‚   โ”‚   โ”œโ”€โ”€ Hero.tsx         # Hero section with animated image### Accessibility Tests

โ”‚   โ”‚   โ”œโ”€โ”€ Navigation.tsx   # Navigation bar

โ”‚   โ”‚   โ”œโ”€โ”€ Projects.tsx     # Featured projects showcase```bash

โ”‚   โ”‚   โ””โ”€โ”€ Skills.tsx       # Skills & technologiesnpm run test:a11y

โ”‚   โ”œโ”€โ”€ utils/                # Utility functions```

โ”‚   โ”‚   โ”œโ”€โ”€ seo.js           # SEO utilities (metadata, schema)

โ”‚   โ”‚   โ””โ”€โ”€ web-vitals.js    # Performance monitoring---

โ”‚   โ”œโ”€โ”€ App.tsx               # Main app component

โ”‚   โ”œโ”€โ”€ main.tsx              # App entry point## ๐Ÿ“ฆ Scripts

โ”‚   โ”œโ”€โ”€ index.css             # Global styles

โ”‚   โ””โ”€โ”€ vite-env.d.ts         # Vite type definitions| Command           | Description              |

โ”œโ”€โ”€ .env.example              # Environment variables template| ----------------- | ------------------------ |

โ”œโ”€โ”€ eslint.config.js          # ESLint configuration| `npm run dev`     | Start development server |

โ”œโ”€โ”€ index.html                # HTML entry point| `npm run build`   | Build for production     |

โ”œโ”€โ”€ package.json              # Dependencies & scripts| `npm run preview` | Preview production build |

โ”œโ”€โ”€ postcss.config.js         # PostCSS configuration| `npm run lint`    | Run ESLint               |

โ”œโ”€โ”€ tailwind.config.js        # Tailwind CSS configuration

โ”œโ”€โ”€ tsconfig.json             # TypeScript configuration---

โ”œโ”€โ”€ tsconfig.app.json         # App TypeScript config

โ”œโ”€โ”€ tsconfig.node.json        # Node TypeScript config## ๐Ÿค Contributing

โ”œโ”€โ”€ vite.config.ts            # Vite configuration

โ””โ”€โ”€ README.md                 # This fileContributions are welcome! Please follow these steps:
  1. Fork the repository

Key Components2. Create a feature branch (git checkout -b feature/AmazingFeature)

  1. Commit your changes (git commit -m 'Add some AmazingFeature')

Hero.tsx4. Push to the branch (git push origin feature/AmazingFeature)

Animated landing section with:5. Open a Pull Request

  • Floating gradient background orbs

  • Animated profile image with rotating gradient border### Code Style

  • Staggered text animations

  • CTA buttons with hover effects- Follow existing code conventions

  • Use TypeScript strict mode

Projects.tsx- Write meaningful commit messages

Professional project showcase with:- Add comments for complex logic

  • 3D card hover effects- Ensure all tests pass

  • Gradient overlays on hover

  • Animated category badges---

  • External link interactions

๐Ÿ“„ License

Contact.tsx

Contact information with:This project is licensed under the MIT License - see the LICENSE file for details.

  • Social media links (GitHub, LinkedIn)

  • Animated contact cards---

  • Form integration ready

๐Ÿ“ง Contact

Utils

  • seo.js: Metadata generation, structured data, Open Graph tagsMd. Ridoy Hasan Kamrul

  • web-vitals.js: Core Web Vitals monitoring (LCP, FID, CLS, INP)

  • ๐Ÿ“ง Email: mdridoyhasankamrul@gmail.com

---- ๐Ÿ”— LinkedIn: md-ridoy-hasan-kamrul

๐ŸŒ Internationalization- ๐Ÿ“ฑ Phone: +880 1680 092066

  • ๐Ÿ“ Location: Dhaka, Bangladesh

The portfolio supports multiple languages using i18next:


Supported Languages

  • ๐Ÿ‡ฌ๐Ÿ‡ง English (default)## ๐Ÿ™ Acknowledgments

  • ๐Ÿ‡ซ๐Ÿ‡ท French

  • React Team for the amazing library

Adding a New Language- Tailwind CSS for the utility-first CSS framework

  • Vite for the blazing fast build tool
  1. Create translation file:- Lucide for the beautiful icons

public/locales/[lang]/translation.json

```---



2. Add translations:## ๐Ÿ“Š Project Statistics

```json

{```

  "nav": {Total Files:       30+

    "home": "Home",Lines of Code:     5000+

    "about": "About",Components:        8

    "projects": "Projects"Languages:         2 (EN, FR)

  }Build Time:        < 10s

}Bundle Size:       < 200KB (gzipped)

  1. Update i18n configuration in main.tsx---

Usage in Components## ๐Ÿ”ฎ Future Enhancements


import { useTranslation } from 'react-i18next';- [ ] Blog section

- [ ] Testimonials

function Component() {- [ ] Project filters

  const { t } = useTranslation();- [ ] Contact form backend

  return <h1>{t('nav.home')}</h1>;- [ ] Newsletter subscription

}- [ ] Analytics integration

```- [ ] More language support



------



## โ™ฟ Accessibility<div align="center">



### **WCAG AA Compliance****Built with โค๏ธ by Md. Ridoy Hasan Kamrul**



โœ… **Keyboard Navigation**โญ Star this repository if you find it helpful!

- All interactive elements focusable

- Logical tab order maintained</div>

- Skip to content link

โœ… **Screen Readers**
- Semantic HTML structure
- ARIA labels on all controls
- Alt text on all images
- Descriptive link text

โœ… **Visual**
- Color contrast โ‰ฅ 4.5:1 for text
- Focus indicators visible
- No reliance on color alone
- Scalable text (rem units)

โœ… **Motion**
- Respects `prefers-reduced-motion`
- Animations can be disabled
- No auto-playing content

### **Testing Accessibility**

```bash
# Install axe DevTools browser extension
# Or use Lighthouse accessibility audit
npm run build && npm run preview

๐Ÿ”ง Configuration

Vite Configuration

Optimized build settings in vite.config.ts:

export default defineConfig({
  build: {
    minify: 'terser',
    terserOptions: {
      compress: { drop_console: true },
    },
    rollupOptions: {
      output: {
        manualChunks: {
          'react-vendor': ['react', 'react-dom'],
          animation: ['framer-motion'],
        },
      },
    },
  },
});

Tailwind Configuration

Custom theme in tailwind.config.js:

module.exports = {
  content: ['./index.html', './src/**/*.{js,ts,jsx,tsx}'],
  theme: {
    extend: {
      colors: {
        // Custom color palette
      },
      animation: {
        // Custom animations
      },
    },
  },
};

TypeScript Configuration

Strict mode enabled in tsconfig.json:

{
  "compilerOptions": {
    "strict": true,
    "noImplicitAny": true,
    "strictNullChecks": true
  }
}

๐Ÿ“ฆ Build & Deployment

Production Build

npm run build

Output in dist/ directory:

  • Minified JavaScript bundles
  • Optimized CSS
  • Compressed assets
  • Source maps (optional)

Deployment Platforms

Vercel (Recommended)

npm install -g vercel
vercel --prod

Netlify

npm install -g netlify-cli
netlify deploy --prod --dir=dist

GitHub Pages

npm run build
# Push dist folder to gh-pages branch

Docker

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build
FROM nginx:alpine
COPY --from=0 /app/dist /usr/share/nginx/html

Environment Variables for Production

VITE_ANALYTICS_ENDPOINT=https://analytics.example.com
VITE_APP_URL=https://mdridoyhasankamrul.com
VITE_GTM_ID=GTM-XXXXXXX

๐Ÿงช Development Tools

Code Quality

# Linting
npm run lint

# Type checking
npm run typecheck

# Format code (with Prettier)
npm run format

Performance Monitoring

// In browser console
import { getPerformanceSummary } from './src/utils/web-vitals';
console.log(getPerformanceSummary());

SEO Validation

Use the following tools to validate SEO:

Browser Support

Chrome   >= 90
Firefox  >= 88
Safari   >= 14
Edge     >= 90

๐Ÿ“ License

This project is licensed under the MIT License.

MIT License

Copyright (c) 2024 Md. Ridoy Hasan Kamrul

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

๐Ÿ“ง Contact

Let's Build Something Amazing Together! ๐Ÿš€

Md. Ridoy Hasan Kamrul
Frontend Developer | React Specialist | MERN Stack Developer

Portfolio LinkedIn GitHub Email

๐Ÿ“ Location: Dhaka, Bangladesh
๐Ÿ“ง Email: mdridoyhasankamrul@gmail.com
๐Ÿ’ผ Available for: Freelance Projects & Full-time Opportunities


๐ŸŒŸ If you found this project helpful, please consider giving it a star!

GitHub Stars


Built with โค๏ธ by Md. Ridoy Hasan Kamrul

Last Updated: January 2025

About

Modern, high-performance portfolio showcasing full-stack development expertise. Built with React 19, TypeScript, and Tailwind CSS featuring smooth Framer Motion animations, GSAP-powered custom cursor, and responsive design. Highlights MERN stack projects with Next.js 16, internationalization, and enterprise-grade implementations.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages