Messenger

A Flutter-based multi-user chat application that supports real-time messaging using Firebase Firestore and Authentication. This app allows users to sign in with email/password or Google and engage in real-time chat with other users.

Table of Contents

1. Features
2. Screenshots
3. Getting Started
   • Prerequisites
   • Installation
   • Project Structure
4. Usage
5. Contributing
6. License
7. Contact

Features

• Firebase Authentication: Sign up and log in with email/password or Google.
• Real-Time Messaging: Chat with other users in real-time.
• Firestore Integration: Store and retrieve messages and user information.
• Responsive UI: A clean, user-friendly interface that works seamlessly on various devices.
• Scalable: Built with Firebase, making it easy to scale as your user base grows.

Screenshots

• Figure 1:

• Figure 2:

Getting Started

Prerequisites

• Flutter SDK: Installation guide
• Firebase account: Firebase Console

Installation

1. Clone the repository:

   git clone https://github.com/sharansukesh1003/messenger.git
   cd messenger

2. Set up Firebase:

   • Create a Firebase project in the Firebase Console.
   • Add your Android and/or iOS app to the Firebase project.
   • Download google-services.json (for Android) and/or GoogleService-Info.plist (for iOS) and place them in the appropriate directories:
     • android/app/google-services.json
     • ios/Runner/GoogleService-Info.plist
   • Enable Email/Password and Google sign-in methods in the Authentication section of Firebase.
   • Set up Firestore as your database and adjust the rules as needed.

3. Install dependencies:

   flutter pub get

4. Run the app:

   flutter run

Project Structure

lib/
│
├── models/
│   ├── chat_screen_arguments_model.dart   # Data model for passing chat arguments
│   └── message_model.dart                 # Data model for chat messages
│
├── screens/
│   ├── chat_screen.dart                   # UI for the chat interface
│   ├── home_screen.dart                   # UI for displaying user list
│   ├── login_screen.dart                  # UI for user login
│   └── signup_screen.dart                 # UI for user signup
│
├── service/
│   ├── authentication.dart                # Firebase authentication service
│   └── message_service.dart               # Firestore message handling service
│
├── widgets/
│   └── message_bubble.dart                # Widget for displaying chat messages
│
└── main.dart                              # Main entry point of the app

Usage

• Sign Up: Users can sign up using their email and password or through Google sign-in.
• Login: Once registered, users can log in and start chatting.
• Chat: Users can select other users from the list and start a conversation in real-time.

Contributing

Contributions are welcome! Please fork this repository and submit a pull request for any changes you'd like to see.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

If you have any questions or suggestions, feel free to open an issue or reach out to me on LinkedIn.