Portfolio Website 🌐

A modern, responsive portfolio website built with pure HTML, CSS, and JavaScript. Showcase your projects, skills, and professional journey with style!

Table of Contents 📖

• Features
• Tech Stack
• Installation
• Customization
• Deployment
• Contributing
• License
• Contact

✨ Features

• Responsive Design: Mobile-first approach with flexbox and CSS grid
• Dark/Light Mode: Toggle between themes with localStorage persistence
• Project Showcase: Grid layout with hover effects and filtering options
• Interactive Elements: Smooth scroll, animated counters, and form validation
• SEO Optimized: Semantic HTML and meta tags for better search visibility
• Performance: Optimized assets and lazy loading for fast page loads

💻 Tech Stack

• Frontend: HTML5, CSS3 (Sass), JavaScript (ES6+)
• Build Tools: Webpack (optional for Sass compilation)
• Hosting: Compatible with GitHub Pages, Netlify, Vercel

🛠 Installation

1. Clone the repository

   git clone https://github.com/Niyaz-Mahmud/Portfolio-Website.git
   cd Portfolio-Website

2. Install dependencies (optional)

   npm install  # Only if using Sass/Webpack

3. Start development server

   npm start  # Launches Live Server with Sass compilation

   or
   Open index.html directly in your browser

🎨 Customization

Content Updates

1. Personal Info: Edit data/config.json
2. Projects: Modify data/projects.json
3. Skills: Update data/skills.json

Style Changes

• Colors: Modify CSS variables in css/root.css
• Typography: Update font imports in css/typography.css
• Layout: Adjust media queries in css/responsive.css

Advanced Modifications

• Add new sections in index.html
• Create custom animations in css/animations.css
• Enhance interactions in js/main.js

🚀 Deployment

Choose your preferred hosting platform:

GitHub Pages

1. Push to main branch
2. Go to Settings > Pages
3. Set source branch to main and folder to / (root)

🤝 Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create your feature branch:

   git checkout -b feature/amazing-feature

3. Commit your changes:

   git commit -m 'Add amazing feature'

4. Push to the branch:

   git push origin feature/amazing-feature

5. Open a Pull Request

Please ensure your code follows our style guidelines and includes relevant tests.

📄 License

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

📧 Contact

Niyaz Mahmud

---

⭐ Star this repo if you found it useful!
💻 Happy Coding!