Meet The Superheroes

Meet The Superheroes is a mobile application built with Android Jetpack Compose. The app showcases a list of unique superheroes, each with their own detailed stories and abilities. Users can click on any superhero to view their detailed profile and read their story.

Features

• Display a list of superheroes with their names, images, and short descriptions.
• Click on a superhero to view their detailed profile and read their story.
• Navigate back to the home screen from the details screen.

Screenshots

Installation

To run this project locally, follow these steps:

1. Clone the repository:

   git clone https://github.com/gitbiruk2010/Build-Superheroes-App

2. Open the project in Android Studio:

   • Open Android Studio and select File -> Open....
   • Navigate to the cloned directory and select it to open the project.

3. Build the project:

   • Let Android Studio download the required dependencies.
   • Build the project by selecting Build -> Make Project.

4. Run the application:

   • Connect your Android device or start an emulator.
   • Click on the Run button or select Run -> Run 'app'.

Usage

• Home Screen: Displays a list of superheroes.
• Hero Details Screen: Click on any superhero from the home screen to view their detailed profile and read their story.
• Back Navigation: Use the back button on the hero details screen to return to the home screen.

Contributing

Contributions are welcome! Please follow these steps to contribute:

1. Fork the repository.

2. Create a new branch:

   git checkout -b feature/your-feature-name

3. Make your changes.

4. Commit your changes:

   git commit -m "Add some feature"

5. Push to the branch:

   git push origin feature/your-feature-name

6. Open a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Source code was taken from

google developers team

Thank you for checking out Meet The Superheroes!