CONTRIBUTING.md

Firefighter

FireFighter inventory management app for Hackwell2.0

Getting Started

Set it up locally!

Fork it

You can get your own fork/copy of this project by using the Fork button.

Clone it

You need to clone (download) it to local machine using

$ git clone https://github.com/<YOUR_USERNAME>/Firefighter.git

Once you have cloned the repository, move to that folder first using cd command.

$ cd Firefighter

Move to this folder for all other commands.

Set it up

Run the following commands to see that your local copy has a reference to your forked remote repository in Github

$ git remote -v
origin  https://github.com/<YOUR_USERNAME>/Firefighter.git (fetch)
origin  https://github.com/<YOUR_USERNAME>/Firefighter.git (push)

Now, lets add a reference to the original Firefighter repository using

$ git remote add upstream https://github.com/VarunSAthreya/Firefighter.git

This adds a new remote named upstream.

Verify the changes using

$ git remote -v
origin    https://github.com/<YOUR_USERNAME>/Firefighter.git (fetch)
origin    https://github.com/<YOUR_USERNAME>/Firefighter.git (push)
upstream  https://github.com/VarunSAthreya/Firefighter.git (fetch)
upstream  https://github.com/VarunSAthreya/Firefighter.git (push)

Sync it

Always keep your local copy of repository updated with the original repository.

Before making any changes and/or in an appropriate interval, run the following commands carefully to update your local repository.

# Fetch all remote repositories and delete any deleted remote branches
$ git fetch --all --prune

# Switch to `main` branch
$ git checkout main

# Reset local `main` branch to match `upstream` repository's `main` branch
$ git reset --hard upstream/main

# Push changes to your forked `Firefighter` repo
$ git push origin

You're Ready to Go

Once you have completed these steps, you are ready to start contributing or raise Issues and creating pull requests.

---

Installation

Make sure you have following installed on your machine:

• Flutter SDK
• Android Studio or VSCode

To setup Flutter in Android Studio check here

To setup Flutter in VSCode check here

• Install flutter dependencies using:

$ flutter pub get

• Setup Firebase(Only Android for now): For more details check here

• Setup GCP Project

• Integrate Maps API

• Replace the GCP API key in the file android/app/src/main/AndroidManifest.xml with YOUR-API-KEY

Run the app using:

$ flutter run

Upload firebase functions:

$ firebase deploy --only functions

---

Create a new branch

Whenever you are going to make contribution. Please create separate branch using the command and keep your main branch clean and most stable version of your project (i.e. synced with remote branch).

# It will create a new branch with name <YOUR GITHUB USERNAME>/<ISSUE NUMBER> and switch to that branch
$ git checkout -b <YOUR GITHUB USERNAME>/<ISSUE NUMBER>
#Example
#$ git checkout -b monatheoctocat/1

Create a separate branch for contribution and try to use same name of branch as of your contributing feature associated with your assigned issue.

To switch to desired branch

# To switch from one branch to other
$ git checkout <BRANCH NAME>

To add the changes to the branch. Use

# To add all files to branch <YOUR GITHUB USERNAME>/<ISSUE NUMBER>
$ git add .

Type in a message relevant for code using

# This message get associated with all files you have changed
$ git commit -m '<relevant message>'

Now, Push your awesome work to your remote repository using

# To push your work to your remote repository
$ git push -u origin <BRANCH NAME>
#Example
#$ git push -u origin <YOUR GITHUB USERNAME>/<ISSUE NUMBER>

Finally, go to your repository in browser and click on compare and pull requests.