Shopping List

An Android based application to help users keep track of items they need when shopping.

This application helps you create and manage your shopping list in real time while having a smooth and stress free experience doing it. It aims to provide a simple look and an easy to use interface for the user.

Screenshots

Installing

Fork the repository.
Clone the repo using the terminal command. Make sure you replace username with your GitHub username.

git clone https://github.com/username/Shopping-List.git

Setting up Shopping List

Download the Shopping List project source. You can do this either by forking and cloning the repository (recommended if you plan on pushing changes) or by downloading it as a ZIP file and extracting it.
Open Android Studio, you will see a Welcome to Android window. Under Quick Start, select Import Project (Eclipse ADT, Gradle, etc.)
Navigate to the directory where you saved the android project, select the root folder of the project (the folder named "Shopping-List"), and hit OK. Android Studio should now begin building the project with Gradle.
Once this process is complete and Android Studio opens, check the Console for any build errors.

Note: If you receive a Gradle sync error titled, "failed to find ...", you should click on the link below the error message (if available) that says Install missing platform(s) and sync project and allow Android studio to fetch you what is missing.

Once all build errors have been resolved, you should be all set to build the app and test it.
To Build the app, go to Build>Make Project (or alternatively press the Make Project icon in the toolbar).
If the app was built successfully, you can test it by running it on either a real device or an emulated one by going to Run>Run 'app' or pressing the Run icon in the toolbar.

Contributing

If you would love to contribute to the app or add a new feature, please fork the project and submit a pull request. Whether you have ideas, translations, design changes, code cleaning, or real heavy code changes, help is always welcome. The more it is done the better it gets!

Author

Mayokun Adeniyi

License

Shopping List is licensed under the MIT License. You can find the license text in the LICENSE file.

mayokunadeniyi/Shopping-List-V1