Skip to content

tanvir-chy-ahmed/random_users

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“± Flutter Random User Directory App

This Flutter app displays a list of random users fetched from the Random User API. 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/
  • 🧍 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
User List Screen User Detail Screen

πŸš€ Getting Started

  1. Clone the repo
git clone https://github.com/tanvir-chy-ahmed/random_users.git
cd flutter-randomuser-app
  1. Install packages
flutter pub get
  1. Run the app
flutter run

πŸ”— API

This project uses:

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
πŸ’» GitHub


πŸ“„ License

This project is open-source and free to use.

About

πŸ“± Flutter Random User Directory App

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages