Skip to content

Derkaoui05/project1

Repository files navigation

🌟 Yassir Derkaoui - Portfolio Website

A modern, responsive portfolio website showcasing my journey as a full-stack developer. Built with clean architecture, optimized performance, and smooth animations to create an engaging user experience.

Live Demo GitHub Stars License

🚀 Features

Core Features

  • Responsive Design - Perfect experience on all devices
  • Modern UI/UX - Clean, professional, and intuitive interface
  • Smooth Animations - Engaging micro-interactions and transitions
  • Performance Optimized - Lazy loading, image optimization, and fast loading times
  • Clean Architecture - Well-organized, scalable codebase

🎯 Sections

  • Hero - Dynamic introduction with call-to-action
  • About - Personal story and professional background
  • Skills - Technical expertise and tools
  • Experience - Work history and achievements
  • Education - Academic background and certifications
  • Projects - Featured work with live demos and source code
  • Contact - Multiple ways to get in touch

🔧 Technical Highlights

  • Lazy Loading Images - Optimized loading with skeleton states
  • Animated Menu - Custom hamburger menu with smooth transitions
  • Fixed Navigation - Always accessible navigation system
  • Error Boundaries - Graceful error handling
  • SEO Optimized - Meta tags and semantic HTML

🛠️ Tech Stack

Frontend

  • React 18 - Modern React with hooks and functional components
  • Vite - Lightning-fast development and build tool
  • Tailwind CSS - Utility-first CSS framework
  • Framer Motion - Professional animations and transitions

UI Components

  • Custom UI System - Systaliko UI components
  • React Icons - Comprehensive icon library
  • Responsive Design - Mobile-first approach

Performance & Optimization

  • Lazy Loading - Images and components load on demand
  • Code Splitting - Optimized bundle sizes
  • Image Optimization - WebP support and loading states
  • PWA Ready - Progressive Web App capabilities

📁 Project Structure

src/
├── components/
│   ├── layout/           # Layout components (Header, Footer, Menu)
│   ├── sections/         # Page sections (Hero, About, Projects, etc.)
│   ├── common/           # Reusable components (Loading, OptimizedImage)
│   ├── ui/               # UI components
│   └── systaliko-ui/     # Custom UI system
├── data/                 # Organized data files
│   ├── personal.js       # Hero, About, Contact information
│   ├── experience.js     # Work experience data
│   ├── education.js      # Education and certifications
│   ├── projects.js       # Portfolio projects
│   ├── navigation.js     # Menu navigation data
│   └── index.js          # Central export point
├── assets/               # Images and static files
├── utils/                # Utility functions

🚦 Getting Started

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn package manager

Installation

  1. Clone the repository

    git clone https://github.com/Derkaoui05/project1.git
    cd portfolio
  2. Install dependencies

    npm install
  3. Start development server

    npm run dev
  4. Open in browser

    http://localhost:5173
    

Build for Production

npm run build

Preview Production Build

npm run preview

🎨 Customization

Personal Data

Update your information in the src/data/ directory:

  • personal.js - Hero content, about text, contact info
  • projects.js - Your portfolio projects
  • experience.js - Work experience
  • education.js - Educational background

Styling

  • Modify tailwind.config.js for custom themes
  • Update src/index.css for global styles
  • Customize component styles in respective files

Assets

Replace images in src/assets/ with your own:

  • Profile picture
  • Project screenshots
  • About section image

📱 Browser Support

  • ✅ Chrome (latest)
  • ✅ Firefox (latest)
  • ✅ Safari (latest)
  • ✅ Edge (latest)
  • ✅ Mobile browsers

🤝 Contributing

Contributions, issues, and feature requests are welcome!

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

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

🌟 Show Your Support

If you found this project helpful, please give it a ⭐️ on GitHub!

📞 Contact

Yassir Derkaoui - Full Stack Developer


Made with ❤️ and ☕ by Yassir Derkaoui

PortfolioEmailLinkedIn

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published