https://github.com/tanvir-chy-ahmed/random_users
📱 Flutter Random User Directory App
https://github.com/tanvir-chy-ahmed/random_users
android api apiintegration cross cross-platform dart flutter ios randomuser-api
Last synced: about 2 months ago
JSON representation
📱 Flutter Random User Directory App
- Host: GitHub
- URL: https://github.com/tanvir-chy-ahmed/random_users
- Owner: tanvir-chy-ahmed
- Created: 2025-07-04T09:11:28.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-04T09:20:49.000Z (11 months ago)
- Last Synced: 2025-07-04T10:26:55.561Z (11 months ago)
- Topics: android, api, apiintegration, cross, cross-platform, dart, flutter, ios, randomuser-api
- Language: Dart
- Homepage:
- Size: 55.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📱 Flutter Random User Directory App
This Flutter app displays a list of random users fetched from the [Random User API](https://randomuser.me). It features a list and detail screen, with smooth navigation, gender-based styling, and clean architecture.
---
## ✨ Features
- ✅ Fetches 100 users from [https://randomuser.me/api/](https://randomuser.me/api/)
- 🧍 Gender-based card colors (Red for male, Light Yellow for female)
- 👤 Detail screen with:
- Profile image
- Email, phone
- Full address with icons
- Nationality, age, username, and more
---
## 📦 Tech Stack
- ⚙️ **Flutter** (Dart)
- 🖼️ **Image.network** for profile photos
- 🌐 **HTTP** package for API calls
- 🧠 **Clean architecture**: models, services, screens, utils
---
## 🗂️ Folder Structure
```
lib/
├── model/ # Data models for user fields
│ └── name_model.dart, location_model.dart, etc.
├── screens/ # UI screens
│ ├── home.dart # User list
│ └── detail.dart # User detail view
├── services/
│ └── apiservices.dart # API calling logic
├── util/
│ ├── api.dart # API base URL
│ └── endpoints.dart # API endpoints
└── main.dart # App entry point
```
---
## 📸 Screenshots
| User List Screen | User Detail Screen |
|------------------|--------------------|
|  |  |
---
## 🚀 Getting Started
1. **Clone the repo**
```bash
git clone https://github.com/tanvir-chy-ahmed/random_users.git
cd flutter-randomuser-app
```
2. **Install packages**
```bash
flutter pub get
```
3. **Run the app**
```bash
flutter run
```
---
## 🔗 API
This project uses:
> [https://randomuser.me/api/?results=100](https://randomuser.me/api/?results=100)
---
## 🛠️ To Improve
- Search/filter by name or country
- Pagination or infinite scroll
- Dark mode support
- Error handling and loading shimmer
---
## 👨💻 Developer
**Tanvir Ahmed Chowdhury**
📧 [tanvirchy269@gmail.com]
🔗 [LinkedIn](https://www.linkedin.com/in/tanvir-ahmed-chy-126191367/)
💻 [GitHub](https://github.com/tanvir-chy-ahmed)
---
## 📄 License
This project is open-source and free to use.