Skip to content

Youssefali2002/github-repo-finder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”₯ GitHub Repo Finder

GitHub-Repo-Finder-Demo

GitHub stars GitHub forks GitHub issues GitHub license

A modern, responsive web application to find and explore GitHub repositories with a beautiful UI and smooth animations. Built with clean, semantic code and best practices.

✨ Features

  • πŸ” Search Repositories: Find any user's public repositories by username
  • πŸ“± Fully Responsive: Works perfectly on desktop, tablet, and mobile devices
  • 🎨 Modern UI: Beautiful gradient design with glassmorphism effects
  • ⚑ Smooth Animations: Engaging hover effects and transitions
  • 🌟 Star Count Display: See repository popularity at a glance
  • πŸ”— Direct Links: Quick access to repository pages
  • πŸ“Š Error Handling: User-friendly error messages for invalid usernames

πŸš€ Live Demo

🌐 Check out the live application: https://youssefali2002.github.io/Code-Finder-GitHub/

πŸ”— Alternative Demo: https://youssefali2002.github.io/github-repo-finder/

Search for any GitHub username (e.g., facebook, microsoft, google) to explore their repositories.

πŸ› οΈ Technologies Used

HTML5 CSS3 JavaScript GitHub API

πŸ“± Responsive Design

The application is fully responsive and optimized for:

  • Desktop (1200px+): Full-featured layout
  • Tablet (768px-1199px): Adaptive design
  • Mobile (480px-767px): Compact, touch-friendly interface
  • Small Mobile (<480px): Optimized for small screens

🎨 UI Features

  • Gradient Background: Eye-catching purple-blue gradient
  • Glassmorphism: Modern frosted glass effect
  • Hover Animations: Interactive elements with smooth transitions
  • Loading States: Visual feedback during data fetching
  • Badge Design: Modern star count display

πŸ“‚ Project Structure

πŸ”₯ GitHub Repo Finder/
β”œβ”€β”€ index.html          # Main HTML structure
β”œβ”€β”€ style.css           # Complete styling with animations
β”œβ”€β”€ main.js             # JavaScript functionality
└── README.md           # Project documentation

πŸš€ Getting Started

  1. Clone the repository

    git clone https://github.com/Youssefali2002/github-repo-finder.git
    cd github-repo-finder
  2. Open in browser

    # Simply open index.html in your favorite browser
    # or use a live server for better experience
  3. Start searching!

    • Enter any GitHub username
    • Click "Get Repos" or press Enter
    • Explore the repositories with beautiful animations

πŸ”§ API Integration

The application uses the GitHub REST API:

  • Endpoint: https://api.github.com/users/{username}/repos
  • Rate Limiting: GitHub's standard API limits apply
  • Error Handling: Comprehensive error messages for:
    • Invalid usernames
    • Network issues
    • Users with no public repositories

🎯 Key Features Explained

Search Functionality

  • Real-time repository fetching
  • Instant results display
  • Error handling for invalid inputs

Responsive Design

  • Flexbox layout for adaptive content
  • Media queries for different screen sizes
  • Touch-friendly mobile interface

Animations

  • slideIn: Main container entrance animation
  • fadeInUp: Repository cards appearance
  • Hover Effects: Interactive feedback on all clickable elements
  • Loading Spinner: Visual feedback during API calls

🌟 Highlights

No Dependencies Fast Performance SEO Friendly Accessibility Cross Browser

  • πŸš€ Zero Dependencies: Pure HTML, CSS, and JavaScript - no build tools required
  • ⚑ Lightning Fast: Optimized for quick loading and smooth performance
  • πŸ” SEO Optimized: Semantic HTML5 structure for better search visibility
  • β™Ώ Accessible: ARIA labels and keyboard navigation support
  • 🌐 Universal: Compatible with all modern browsers

πŸ“Š Browser Support

  • βœ… Chrome 60+
  • βœ… Firefox 55+
  • βœ… Safari 12+
  • βœ… Edge 79+

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  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.

πŸ™ Acknowledgments

  • GitHub API for providing repository data
  • Modern CSS techniques for beautiful UI
  • JavaScript Fetch API for smooth data handling

Made with ❀️ by Youssef Yaser Ismail

πŸ“§ Email: youseef.ali.2002@gmail.com
πŸ”— GitHub: Youssefali2002

Search β€’ Explore β€’ Discover GitHub Repositories

About

πŸ” A sleek, high-performance GitHub repository finder built with Vanilla JavaScript and Fetch API. Featuring CSS3 Glassmorphism UI, smooth animations, and full mobile responsiveness. Zero dependencies!

Topics

Resources

License

Stars

Watchers

Forks

Contributors