Maxtoshie/BookSwap-Flutter

A Text Book Swapping App designed using Flutter as an individual assignment for Mobile Development with Dart and Flutter at The African Leadership University ```markdown # BookSwap Flutter **A real-time book marketplace for students** Swap textbooks with classmates using **Firebase Auth, Firestore, and real-time chat**. --- ## Features | Feature | Status | |-------|--------| | Email + password signup/login | Done | | **Email verification** (enforced) | Done | | Add/Edit/Delete book listings | Done | | Cover image upload (Base64) | Done | | Real-time swap offers (Pending to Accepted) | Done | | **Pro chat** with last message, unread badge, profile pic | Done | | 4-screen navigation: Browse, My Listings, Chats, Settings | Done | | Clean dark UI with yellow accent | Done | --- ## Tech Stack - **Flutter** (Web + Mobile ready) - **Firebase Authentication** (email/password + verification) - **Cloud Firestore** (real-time sync) - **Provider** (state management) - **intl** (date formatting) --- ## Project Structure ``` lib/ ├── models/ to Data classes (Book, Swap, Message) ├── providers/ to State management with Provider ├── screens/ to UI screens │ ├── browse_listings_screen.dart │ ├── my_listings_screen.dart │ ├── chats_screen.dart │ ├── settings_screen.dart │ └── add_edit_book_screen.dart ├── methods/ to Reusable widgets │ ├── custom_button.dart │ └── image_picker.dart ├── constants.dart to Colors, strings, assets └── main.dart to Firebase init + AuthGate ``` --- ## Firebase Data Model ```text users/{uid} ├── displayName ├── email ├── photoURL (optional) └── createdAt books/{bookId} ├── title ├── author ├── condition ├── ownerId ├── imageBase64 └── createdAt → Nov 10, 2025 swaps/{swapId} ├── senderId ├── receiverId ├── bookId ├── status → "Pending" | "Accepted" | "Rejected" └── messages/{msgId} ├── text ├── sender └── time ``` --- ## Setup Instructions 1. **Clone the repo** ```bash git clone github.com cd BookSwap-Flutter ``` 2. **Install dependencies** ```bash flutter pub get ``` 3. **Add Firebase config** - Go to …