A modern, feature-rich GitHub Profile Finder with advanced search, live updates, and beautiful UI
🌐 Live Demo • 📖 Documentation • 🐛 Report Bug • ✨ Request Feature
- ✨ Features
- 🎯 Demo
- 🚀 Quick Start
- 📦 Installation
- 🎨 Screenshots
- 🛠️ Technologies
- 📚 API Reference
- 🤝 Contributing
- 📝 License
- 👨💻 Author
- 💖 Support
- 🌟 Acknowledgments
- ⚡ Live Search with debouncing (400ms) for optimal performance
- 🔍 Real-time search as you type
- 📝 Recent searches with quick access chips (last 3 searches)
- 🎯 Smart error handling (404, rate limits, network errors)
- 🖼️ High-quality avatar display
- 📊 Complete user statistics (repos, followers, following, gists)
- 📍 Location, company, blog, and social links
- 📅 Account creation date
- 📋 Bio and profile information
- ⭐ Top 10 repositories display
- 🔄 Sort by stars, forks, or recent updates
- 🎨 Language color-coded badges (20+ languages)
- 📈 Star and fork counts with formatted numbers
- 📝 Repository descriptions with line clamping
- 🔗 Direct links to repositories
- 🌓 Dark/Light Mode with system preference detection
- 💾 Theme persistence with localStorage
- 📱 Fully responsive design (mobile-first approach)
- ✨ Smooth animations and transitions
- 💀 Skeleton loading screens with shimmer effect
- 🎯 Clean, modern GitHub-inspired design
- 🎭 Glass-morphism effects
- ⚡ Debounced API calls to prevent rate limiting
- 💾 LocalStorage caching for recent searches
- 🎯 Optimized DOM manipulation
- 📦 Lightweight - No frameworks or dependencies
- 🌐 CDN-based resources (Font Awesome)
- 🔄 Efficient re-rendering
- 📋 Copy profile URL to clipboard
- 🔗 Share profiles on social media (native share API)
- 📊 Rate limit tracking and display
- ♿ Full accessibility with ARIA labels
- ⌨️ Keyboard shortcuts (Ctrl+K to focus search, Escape to clear)
- 🔙 Browser history support (back/forward buttons work)
- 🛡️ XSS protection with input sanitization
- 🔐 Secure external links (noopener noreferrer)
https://gitprofilefind.dippanbhusal.tech
Try searching for popular developers:
torvalds(Linus Torvalds - Linux creator)gaearon(Dan Abramov - React core team)tj(TJ Holowaychuk - Express.js creator)sindresorhus(Sindre Sorhus - Prolific open source developer)KDippan(That's me! 😊)
Download and install the app on your Android device!
The app is automatically built and released as an APK using GitHub Actions. Simply download the latest APK from the Releases page and install it on your Android device.
Installation Steps:
- Go to the Releases page
- Download the latest
app-release.apkfile - Enable "Install from Unknown Sources" in your Android settings if needed
- Open the downloaded APK file and install
- Enjoy the app! 🎉
- A modern web browser (Chrome, Firefox, Safari, Edge)
- Internet connection for API calls
- Basic text editor (optional, for modifications)
Deploy your own instance in seconds:
- Click the green "Code" button above
- Select "Download ZIP"
- Extract the ZIP file to your desired location
- Open
index.htmlin your browser - Done! 🎉
# Clone the repository
git clone https://github.com/KDippan/github-profile-finder.git
# Navigate to project directory
cd github-profile-finder
# Open in browser
# For Linux:
xdg-open index.html
# For macOS:
open index.html
# For Windows:
start index.html# Using Python 3
python -m http.server 8000
# Using Python 2
python -m SimpleHTTPServer 8000
# Using Node.js (if installed)
npx live-server
# Using PHP
php -S localhost:8000Then open: http://localhost:8000
Step-by-step guide:
-
Fork this repository
- Click the "Fork" button at the top right
-
Enable GitHub Pages
- Go to your fork's Settings
- Navigate to "Pages" in the left sidebar
- Under "Source", select
mainbranch - Click "Save"
-
Access your site
- Your site will be live at:
https://yourusername.github.io/github-profile-finder/ - It may take a few minutes for the first deployment
- Your site will be live at:
-
Custom Domain (Optional)
- Add a
CNAMEfile with your domain - Configure your domain's DNS settings
- Update the domain in GitHub Pages settings
- Add a
📸 Click to expand and view all screenshots
- HTML5 - Semantic and accessible markup
- CSS3 - Modern styling with custom properties
- Vanilla JavaScript (ES6+) - No frameworks, pure performance
- GitHub REST API v3 - User and repository data
- Font Awesome 6.5.1 - Beautiful icons via CDN
- Async/Await - Modern asynchronous JavaScript
- Debouncing - Performance optimization for API calls
- LocalStorage API - Client-side data persistence
- Fetch API - HTTP requests to GitHub API
- CSS Variables - Dynamic theming
- CSS Grid & Flexbox - Responsive layouts
- Media Queries - Mobile-first responsive design
- Component-based architecture
- State management with JavaScript closures
- Event delegation for better performance
- Lazy loading for images
- Error boundary pattern
| Browser | Version |
|---|---|
| ✅ Chrome | 90+ |
| ✅ Firefox | 88+ |
| ✅ Safari | 14+ |
| ✅ Edge | 90+ |
| ✅ Opera | 76+ |
This project uses the GitHub REST API (v3) to fetch user and repository data [web:14].
| Authentication | Requests per Hour |
|---|---|
| Unauthenticated | 60 |
| Authenticated | 5,000 |
💡 Tip: The app displays remaining API calls when you're running low!
1. Get User Profile
GET https://api.github.com/users/{username}
// Response includes: avatar, name, bio, location, company,
// blog, twitter, repos count, followers, following, etc.2. Get User Repositories
GET https://api.github.com/users/{username}/repos
?sort=updated
&per_page=100
&type=owner
// Returns array of repositories with name, description,
// language, stars, forks, etc.To get 5,000 requests/hour instead of 60:
-
Generate Personal Access Token
- Go to GitHub Settings → Developer settings → Personal access tokens
- Click "Generate new token (classic)"
- Name it (e.g., "GitHub Profile Finder")
- No scopes needed for public data
- Copy the token
-
Add to script.js
// In the fetchWithRateLimit function const response = await fetch(url, { headers: { 'Accept': 'application/vnd.github.v3+json', 'Authorization': 'token YOUR_TOKEN_HERE' } });
- Never commit tokens to GitHub!
- Use environment variables in production
- Add
.envto.gitignore
📖 Full docs: https://docs.github.com/en/rest
Contributions make the open source community amazing! Any contributions you make are greatly appreciated! 🎉
- Star this repository ⭐
- Fork the Project
- Create your Feature Branch
git checkout -b feature/AmazingFeature
- Commit your Changes
git commit -m 'Add some AmazingFeature' - Push to the Branch
git push origin feature/AmazingFeature
- Open a Pull Request
- Read CONTRIBUTING.md for detailed guidelines
- Follow the Code of Conduct
- Write clear, concise commit messages
- Add comments for complex code
- Test your changes thoroughly
- Update documentation as needed
New to open source? Look for issues labeled:
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License - Copyright (c) 2026 Dippan Bhusal
TL;DR: You can use, modify, and distribute this project freely. Just include the license!
Full-Stack Developer | Open Source Enthusiast | Tech Content Creator
"Building cool stuff and sharing knowledge"
If you find this project helpful, please consider supporting! Your support helps me create more awesome open-source projects.
Your coffee keeps the code flowing! ☕
Become a sponsor and get your name/logo here!
Give this project a star if you like it!
It helps others discover this project and motivates me to keep improving it.
Special thanks to:
- GitHub - For the amazing API
- GitHub REST API Documentation - Comprehensive and clear docs
- Font Awesome - Beautiful icon library
- Shields.io - For awesome README badges
- Netlify & Vercel - Free hosting platforms
- All Contributors - Everyone who has contributed to this project
Built with passion to solve the need for a modern, fast, and beautiful GitHub profile search tool with excellent user experience.
- Basic search functionality
- User profile display with statistics
- Repository showcase with sorting
- Dark/Light theme toggle
- Fully responsive design
- Recent searches feature
- Rate limit tracking
- Copy/Share functionality
- Keyboard shortcuts
- Accessibility improvements
- User contribution graph visualization
- Repository language statistics with charts
- Export profile as PDF
- Compare two GitHub users side-by-side
- Advanced filters (language, stars, forks)
- Integration with GitHub GraphQL API v4
- Progressive Web App (PWA) support
- Offline mode with caching
- Multi-language support (i18n)
- GitHub Gist viewer
- Organization profile support
- Trending developers section
- GitHub activity timeline
- Follower/Following network graph
- Repository contribution insights
- Custom profile themes
- Browser extension version
Have a feature idea? Open an issue and let's discuss!
Currently tracking issues on the Issues page.
Found a bug? Please report it!
See CHANGELOG.md for a list of changes in each version.
- 🎉 Initial release
- ✨ All core features implemented
- 📱 Fully responsive
- 🌓 Dark/Light mode
- ⚡ Performance optimized
Q: Do I need a GitHub account to use this?
No, you can search any public GitHub profile without an account. However, unauthenticated requests are limited to 60 per hour.
Q: Why do I see "Rate Limit Exceeded"?
GitHub limits unauthenticated requests to 60 per hour. To increase this to 5,000, add a Personal Access Token (see API Reference section).
Q: Can I use this for commercial projects?
Yes! This project is MIT licensed, which allows commercial use. Just include the license file.
Q: How do I deploy this to my own domain?
Simply upload the files to any web hosting service (Netlify, Vercel, GitHub Pages, etc.) and point your domain to it.
Q: Does this work offline?
The app needs internet to fetch data from GitHub's API. However, recent searches are cached locally. PWA support for offline mode is planned for future versions.
Made with ❤️ by Dippan Bhusal
Happy Coding! 🚀
If you have any questions or suggestions, feel free to reach out!