An Android Application that helps you manage your contacts.
- Kotlin
- XML
- Firebase Authentication
- Firebase Realtime Database
Welcome Screen | Login Screen | Sign Up Screen | Dashboard | Add New Contacts |
---|---|---|---|---|
- Any system with basic configuration.
- Operating System: Windows / Linux / Mac
- Android Studio (If not, download it here).
- Basic Knowledge of Git & GitHub.
- Familiar with Kotlin
- Java
- XML
- Firstly to make your copy of the project you have to fork the repository. To fork the repository, press the fork button.
- Now after you have forked the project, it's time to clone it into your local device so that you can work properly.
- In your forked repository click on the green code button and copy the provided link.
- Now on your desktop open Git Bash and type
git clone https://github.com/yourusername/ContactPlus.git
, and press enter - Now, your forked repository has been cloned in your device! 🎉
Make sure your fork is up-to-date and create a topic branch for your feature or bug fix. (The name my-feature-branch
is an example. Choose whatever you like.)
git checkout main
git remote add upstream https://github.com/SmileWithKhushi/ContactPlus.git
git pull upstream main
git checkout -b my-feature-branch
Ensure that you can build the project and run it on your mobile device before you create a pull request.
Implement your feature or bug fix.
Make sure that your app builds and is successfully installed on your mobile device without errors.
Make sure git knows your name and email address:
git config --global user.name "Your Name"
git config --global user.email "contributor@example.com"
Add the changed files to the index using git add. Most IDEs make this easy for you to do, so you won't need this command line version. Writing good commit logs is important. A commit log should describe what changed and why.
git add ...
git commit -m "Fixed Foo bug by changing bar"
git push origin my-feature-branch
Go to https://github.com/yournamehere/ContactPlus and select your feature branch. Click the 'Pull Request' button and fill out the form. Pull requests are usually reviewed within a few days.
If code review requests changes (and it usually will) just git push
the changes to your repository on the same branch, and the pull request will be automatically updated.
If you've been working on a change for a while and other commits have been made to the project, rebase with upstream/master.
git fetch upstream
git rebase upstream/master
git push origin my-feature-branch -f
Go back to your pull request after a few minutes/days and see whether it passed the code-review Everything should be fine if your PR is green ✅ and successfully merged or code changes will be requested by the maintainers.