Skip to content

abdelrahman-samy-dev/kasper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Kasper - Modern Portfolio Website

A sleek, responsive portfolio website built with modern web technologies, featuring smooth animations, interactive elements, and a professional design.

🌐 Live Demo

View Live Demo β†’

Website Preview GitHub Pages

🌟 Features

Design & User Experience

  • Modern Gradient Design: Eye-catching gradient backgrounds and color schemes
  • Responsive Layout: Fully responsive design that works on all devices
  • Smooth Animations: CSS animations and transitions throughout the site
  • Loading Screen: Professional loading animation on page load
  • Parallax Effects: Subtle parallax scrolling for visual depth

Navigation & Interactions

  • Sticky Header: Fixed navigation header with scroll effects
  • Mobile Menu: Hamburger menu for mobile devices
  • Smooth Scrolling: Animated scrolling between sections
  • Active Section Highlighting: Navigation links highlight based on current section
  • Scroll to Top Button: Floating button to return to top of page

Interactive Components

  • Portfolio Filter: Filter portfolio items by category
  • Counter Animations: Animated number counters in statistics section
  • Testimonials Slider: Auto-advancing testimonial carousel
  • Typing Effect: Animated typing effect for hero title
  • Hover Effects: Interactive hover animations on cards and buttons
  • Button Ripple Effects: Material Design-inspired button animations

Technical Features

  • Intersection Observer: Efficient scroll-based animations
  • CSS Custom Properties: Maintainable CSS with CSS variables
  • Modern CSS: Flexbox and Grid layouts
  • Performance Optimized: Smooth 60fps animations
  • Cross-browser Compatible: Works across modern browsers

πŸš€ Quick Start

Option 1: View Online

Visit the live demo: kasper.abdelrahman-samy-dev.github.io

Option 2: Run Locally

  1. Clone the repository
    git clone https://github.com/abdelrahman-samy-dev/kasper.git
  2. Navigate to project folder
    cd kasper
  3. Open in browser
    # Open index.html in your preferred browser
    # Or use a local server (recommended)
    python -m http.server 8000
    # Then visit: http://localhost:8000

πŸ“ Project Structure

kasper/
β”œβ”€β”€ index.html          # Main HTML file
β”œβ”€β”€ kasper.css         # Main stylesheet
β”œβ”€β”€ main.js            # JavaScript functionality
└── README.md          # Project documentation

πŸ”— Repository Links

🎨 Customization

Colors & Theming

The website uses CSS custom properties for easy theming. Modify these variables in kasper.css:

:root {
    --primary-color: #6366f1;
    --primary-dark: #4f46e5;
    --secondary-color: #64748b;
    --accent-color: #f59e0b;
    --text-dark: #1e293b;
    --text-light: #64748b;
    /* ... more variables */
}

Sections

The website includes these main sections:

  • Hero Section: Landing area with call-to-action
  • Services: Services or skills showcase
  • Portfolio: Project gallery with filtering
  • Statistics: Animated counters for achievements
  • Testimonials: Client testimonials carousel
  • Contact: Contact form and information

Fonts

The project uses Google Fonts:

  • Inter: Main body font
  • Playfair Display: Headings and titles

Add this to your HTML <head>:

<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=Playfair+Display:wght@400;600;700&display=swap" rel="stylesheet">

πŸš€ Deployment

This project is automatically deployed using GitHub Pages. Any changes pushed to the main branch will be automatically reflected on the live website.

Deploy Your Own Version

  1. Fork this repository
  2. Go to Settings β†’ Pages
  3. Select Source: Deploy from a branch
  4. Choose Branch: main
  5. Click Save
  6. Your site will be available at: https://YOUR_USERNAME.github.io/kasper/

πŸ”§ Configuration

Portfolio Filtering

To add portfolio items, use this structure:

<div class="portfolio-item" data-category="web">
    <!-- Portfolio item content -->
</div>

Statistics Counter

For animated counters, use:

<span class="stat-number" data-target="150">0</span>

Testimonials

Add testimonials with this format:

<div class="testimonial">
    <p class="testimonial-text">"Your testimonial text here"</p>
    <div class="testimonial-author">
        <!-- Author info -->
    </div>
</div>

πŸ“± Responsive Breakpoints

  • Desktop: 1200px and above
  • Tablet: 768px - 1199px
  • Mobile: Below 768px

🌐 Browser Support

  • Chrome (latest)
  • Firefox (latest)
  • Safari (latest)
  • Edge (latest)

πŸ“‹ Features Checklist

  • βœ… Responsive design
  • βœ… Loading screen
  • βœ… Sticky navigation
  • βœ… Mobile menu
  • βœ… Smooth scrolling
  • βœ… Portfolio filtering
  • βœ… Animated counters
  • βœ… Testimonials slider
  • βœ… Contact form
  • βœ… Scroll animations
  • βœ… Parallax effects
  • βœ… Typing animation
  • βœ… Button effects
  • βœ… Scroll to top

🎯 Performance Features

  • Intersection Observer: Efficient scroll-based animations
  • CSS Transforms: Hardware-accelerated animations
  • Debounced Scroll Events: Optimized scroll handling
  • Minimal JavaScript: Lightweight and fast loading

πŸ”„ Updates & Maintenance

To update content:

  1. Modify text content in index.html
  2. Update colors in CSS custom properties
  3. Add/remove portfolio items as needed
  4. Customize animations timing in JavaScript

πŸ“„ License

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

🀝 Contributing

Contributions are welcome! Here's how you can help:

  1. Fork the repository
  2. Create a 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

Issues

Found a bug or have a suggestion? Open an issue

⭐ Show Your Support

If you like this project, please consider:

πŸ“ž Contact & Support


⚑ Built with modern web technologies | πŸš€ Deployed on GitHub Pages | ❀️ Made with passion

GitHub followers GitHub stars