Giter Club home page Giter Club logo

powerup-android's Introduction

PowerUp - Android

PowerUp is a female empowerment educational mobile game app that will allow young girls to learn about reproductive health and self-esteem by navigating the life of their avatar!

Setup for Developers

  1. Make sure you have downloaded the latest version of Android Studio. It works on Linux, Windows and Mac. Download the correct version for your OS
  2. Go to the project repo and fork it by clicking "Fork"
  3. If you are working on Windows, download Git Bash for Windows to get a full Unix bash with Git functionality
  4. Clone the repo to your desktop git clone [email protected]:your_name/powerup-android.git
  5. Open the project with Android Studio

Configure remotes

When a repository is cloned, it has a default remote called origin that points to your fork on GitHub, not the original repository it was forked from. To keep track of the original repository, you should add another remote named upstream:

  1. Open terminal or git bash in your local repository and type:

    git remote add upstream

  2. Run git remote -v to check the status, you should see something like the following:

origin (fetch)

origin (push)

upstream (fetch)

upstream (push)

  1. To update your local copy with remote changes, run the following:

    git fetch upstream

    git merge upstream/master

    This will give you an exact copy of the current remote, make sure you don't have any local changes.

Contributing and developing a feature

  1. Make sure you are in the master branch git checkout master
  2. Sync your copy git pull
  3. Create a new branch with a meaningful name git checkout -b branch_name
  4. Develop your feature on Android Studio and run it using the emulator or connecting your own Android device
  5. Clean your project from Android Studio Build/Clean project
  6. Add the files you changed git add file_name (avoid using git add .)
  7. Commit your changes git commit -m "Message briefly explaining the feature"
  8. Keep one commit per feature. If you forgot to add changes, you can edit the previous commit git commit --amend
  9. Push to your repo git push origin branch-name
  10. Go into the Github repo and create a pull request explaining your changes
  11. If you are requested to make changes, edit your commit using git commit --amend, push again and the pull request will edit automatically
  12. You will need to add a message on the pull request notifying your changes to your reviewer

Documentation of PowerUp (Android)

Here's the link to the official documentation: Visit Documentation!

##Coding Guidelines

  1. Don't use magic numbers or hard-coded strings. Put them in dimens.xml or strings.xml
  2. Class names should be in CamelCase. Name activities with names including Activity so it's easier to know what they are.
  3. Include spaces between parameters when you call a method for example: Intent(MainActivity.this, GameActivity.class).
  4. Give relevant names to buttons and other resources.
  5. Use @id instead of @+id when referring to resources that have been already created in xml files.

powerup-android's People


aaskashah avatar acoconut avatar alma-castant avatar chhavip avatar harshitakasera avatar vasukiarunachalam avatar yatna avatar


 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.