gerardocipriano/pokeglass-android-app

Pokéglass is an Android app written in Kotlin that allows users to search for their favorite Pokémon and view their information such as name and basic stats. Save your favorite Pokémon locally and stay up-to-date with the latest Pokémon data.

PokèGlass

Pokéglass is an Android app written in Kotlin that allows users to search for their favorite Pokémon and view their information such as name and basic stats. Save your favorite Pokémon locally and stay up-to-date with the latest Pokémon data.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

The goal of developing this Android App is to create a simple and intuitive user experience for creating and managing your own Pokémon team.

(back to top)

Built With

• Kotlin
• Android Studio

(back to top)

Getting Started

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

Prerequisites

At least Android 4.4+

Installation

1. Simply get the apk contained in this Repo and install it on your android device.

(back to top)

Usage

Pokedex

From the main page, you can browse and search for your favorite Pokémon. Once you have decided which Pokémon you would like to add to your team, simply click the “Add” button. Please note that you cannot have more than one Pokémon with the same name on your team, and your team can have a maximum of 6 Pokémon.

Team

From this page, you can view all the Pokémon that you have added to your team. You can consult their base stats and remove them from your team if you wish.

(back to top)

Roadmap

Mandatory Features

• The application must use API calls to fetch and display pokedex data in your app.
• Favorite Pokémon search: The application must allow users to search for their favorite Pokémon using keywords or filters.
• Information display: The application must display information about the searched Pokémon, such as its name, image, and basic statistics such as attack, defense, and speed.
• Favorite Pokémon saving: The application must allow users to save their own Pokémon team (max. 6) locally using a database.

Optional Features

• Users can save more than one pokemon team

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Gerardo Cipriano - gerardo.cipriano@studio.unibo.it

Project Link: https://github.com/gerardocipriano/pokeglass-android-app

(back to top)