Skip to content

README.md

Latest commit

 

History

History
65 lines (46 loc) · 1.98 KB

README.md

File metadata and controls

65 lines (46 loc) · 1.98 KB

🧭 GitHub Explorer

A beautiful, fast, and modern GitHub repository browser built with Flutter & Clean Architecture.

GitHub Explorer
Explore GitHub users and their repositories with style.

✨ Features

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

🖼️ Screenshots

Home (Grid) Repo Detail Search History
Grid View Detail History

🧰 Tech Stack

  • 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

🚀 Getting Started

Prerequisites

  • Flutter SDK ≥ 3.0.0
  • Dart
  • Android Studio / VS Code

Installation

# 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