A beautiful, fast, and modern GitHub repository browser built with Flutter & Clean Architecture.
Explore GitHub users and their repositories with style.
| Feature | Description |
|---|---|
| User Search | Enter any GitHub username to view profile & repositories |
| List/Grid View | Toggle between list and grid layouts |
| Smart Sorting | Sort by: Name (A–Z / Z–A), Date, Stars |
| Rich Repo Details | View description, stats, language, dates, and open directly on GitHub |
| User Header | Beautiful user header with avatar, name, bio, and stats (repos, followers, following) |
| Search History | Last 10 usernames saved locally for quick access |
| Dark/Light Mode | Seamless theme toggle support |
| Professional UI | Built with Material 3 — responsive, modern, and accessible |
| Home (Grid) | Repo Detail | Search History |
|---|---|---|
 |
 |
 |
- Framework: Flutter (Dart)
- Architecture: Clean Architecture
- State Management:
flutter_bloc - Dependency Injection:
get_it - Local Storage:
shared_preferences - Networking:
http - Image Caching:
cached_network_image - URL Launching:
url_launcher
- Flutter SDK ≥ 3.0.0
- Dart
- Android Studio / VS Code
# Clone the repository
git clone https://github.com/Mahfuz-00/github_explorer.git
cd github_explorer
# Get dependencies
flutter pub get
# Run the app
flutter run