🚀 RepoRover

Discover amazing GitHub repositories with a single click!

RepoRover is a modern, responsive web application that helps developers explore random GitHub repositories by programming language. Built with Vue 3, it features smooth animations, real-time search, and an intuitive shuffle mechanism to discover new projects without making additional API calls.

🌐 Live Demo

Live Site: https://reporover.vercel.app

✨ Features

• 🔍 Smart Search - Search repositories by 50+ programming languages
• 🎲 Instant Shuffle - Explore different repositories without additional API calls
• 🎨 Modern UI - Clean, professional design with smooth animations
• 📱 Fully Responsive - Works seamlessly on desktop, tablet, and mobile
• ⚡ Fast Performance - Efficient data fetching and caching
• 🎯 Error Handling - Custom error messages for different scenarios
• 🌓 Smooth Transitions - Beautiful animations when shuffling repositories

🛠️ Tech Stack

Frontend

• Vue 3 - Progressive JavaScript framework
• Vite - Next-generation frontend tooling
• Axios - Promise-based HTTP client

APIs

• GitHub REST API - Repository search and data

Styling

• CSS Variables - Custom design system
• CSS Grid & Flexbox - Responsive layouts
• CSS Animations - Smooth transitions

---

🚀 Getting Started

Prerequisites

• Node.js (v16 or higher)
• npm or pnpm

Installation

1. Clone the repository

   git clone https://github.com/pasify/RepoRover.git
   cd RepoRover

2. Install dependencies

   npm install
   # or
   pnpm install

3. Run development server

   npm run dev
   # or
   pnpm dev

4. Open your browser

   http://localhost:5173

Build for Production

npm run build
# or
pnpm build

---

📖 Usage

1. Select a Language: Choose from 50+ programming languages in the dropdown
2. Search: Click "Search Repository" to fetch repositories
3. Explore: Browse through 3 randomly selected repositories
4. Shuffle: Click "Shuffle Repositories" to see 3 different repos from the fetched set (no new API call!)
5. Fetch New: Click "Fetch New" to get a fresh set of repositories from GitHub

---

🐛 Known Issues

• GitHub API has a rate limit of 60 requests per hour for unauthenticated requests
• Some languages may return fewer than 100 repositories

---

🔮 Future Enhancements

• Add authentication for higher API rate limits
• Implement favorites/bookmarking system
• Add filters (stars, forks, recent activity)
• Dark mode toggle
• Share repository links
• Search history
• Progressive Web App (PWA) support
• Multiple language selection
• Trending repositories section

---

🤝 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 REST API - Repository data
• Vue.js - Frontend framework
• Inspired by the need to discover new open-source projects

---

👨‍💻 Author

Paskkal.IO

• GitHub: @Pasify
• Portfolio: paskkal.io

---

📧 Contact

For questions or feedback, please open an issue

---

Made with ❤️ and Vue.js

⭐ Star this repo if you found it helpful!