A sleek, responsive React application that lets you discover, search, and filter GitHub repositories using the GitHub REST API. Built with Vite + React and TailwindCSS, with a small, focused codebase and accessible components.
Home — search, filters, and repo list
Repo modal — details, stats and links
- Search Repositories — Real-time search with a debounce hook (
useDebounce) for better UX. - Filters — Language and sorting selectors to narrow results (Stars, Forks, Updated).
- Repo Details Modal — Rich details view with topics, license, issues, and quick link to GitHub.
- Responsive Design — Layouts and modal scale up for larger screens (desktop & large monitors).
- Accessible UI — Built using Radix primitives and simple semantics.
- Infinite Loading / Pagination — "Load More" style loading for additional results.
- Error Handling — Graceful handling of API errors and rate limit feedback.
- Frontend: React, Vite
- Styling: TailwindCSS
- Icons: Lucide React
- Components: Radix UI primitives
- Hooks: Custom
useDebouncefor search
-
Clone the repository
git clone https://github.com/JeetMajumdar2003/repo-recommender.git cd repo-recommender -
Install dependencies
npm install
-
Start the development server
npm run dev
-
Build for production
npm run build
This app uses the public GitHub API. Unauthenticated requests are subject to GitHub's rate limits. If you hit the limit, the UI will show an error message with guidance to try again later or use an authenticated token.
Contributions are welcome — feel free to open issues or PRs for bug fixes, enhancements, or accessibility improvements.
MIT License. See the LICENSE file for details.