The "Princee" Flutter app is a mobile application developed using Flutter and Firebase. The app provides an authentication system and redirects users to the home page if they are logged in; otherwise, it takes them to the login page. The project follows the MIT License, granting permission for others to use, modify, and distribute the software.
To download and access the project, follow these steps:
-
Clone the Repository: Clone the "Princee" repository from GitHub using the following command in your terminal or command prompt:
git clone https://github.com/follow-prince/Princee.git -
Flutter Installation: Ensure you have Flutter installed on your system. If you don't have Flutter installed, follow the official Flutter installation guide (https://flutter.dev/docs/get-started/install) for your operating system.
-
Firebase Configuration: Since the project uses Firebase, you need to set up a Firebase project and obtain the configuration information (API Key, App ID, Messaging Sender ID, Project ID). Replace the corresponding values in the
lib/main.dartfile with your Firebase configuration. -
Dependencies: The project depends on Firebase and other Flutter packages. Ensure you have all the required dependencies installed by running the following command in the project directory:
flutter pub get
GroupChatApp is a Flutter-based Group Chatting application that allows users to create and participate in group conversations. The app uses Firebase as the backend to store and manage chat messages and user authentication.
- User registration and authentication
- Create new chat groups
- Send and receive messages in real-time
- View the list of all chat groups
- Real-time updates on new messages
- Group management (Add/remove members)
Coming Soon
Follow these steps to set up and run the project on your local machine:
- Clone the repository:
git clone https://github.com/follow-prince/princee.git - Change into the project directory:
cd princee - Install dependencies:
flutter pub get - Run the app:
flutter run
To use Firebase for the backend, follow these steps:
- Create a new project on Firebase
- Enable the Firestore database and Firebase Authentication in your project settings
- Add your Firebase configuration file to the app (
android/app/google-services.jsonandios/Runner/GoogleService-Info.plist)
If you would like to collaborate or contribute to the "Princee" project, consider the following steps:
-
Fork the Repository: Fork the "Princee" repository to your GitHub account by clicking the "Fork" button on the top-right corner of the repository page.
-
Create a Branch: Create a new branch in your forked repository to work on your changes. You can name the branch based on the feature or bug fix you are implementing.
-
Make Changes: Make the desired changes to the codebase using your preferred code editor or IDE.
-
Commit and Push: Once you have made the necessary changes, commit the changes with appropriate commit messages and push the changes to your forked repository.
-
Create Pull Request: Go to the original "Princee" repository and click on the "New Pull Request" button. Select your branch and provide a brief description of the changes you made. Submit the pull request for review.
-
Code Review: The project maintainers will review your code, suggest any changes if needed, and merge your changes into the main project if everything looks good.
The "Princee" Flutter app is released under the MIT License, which allows free use, modification, distribution, and selling of the software. However, it requires that the original copyright notice and permission notice are included in all copies or substantial portions of the software.
Copyright (c) 2023 Mr.Prince
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
The "Princee" Flutter app is a great example of a mobile application with Firebase authentication. With the provided instructions, you can easily download, access, and collaborate on the project using GitHub. The open-source nature of the project allows developers to contribute and build upon it. Happy coding!