<div align="center"> </br> <img src="https://github.com/PalankiBharat/HeroIo/blob/master/composeApp/src/androidMain/ic_launcher_hero-playstore.png" width="200" height="200" /> </div>

HeroIO

The Superhero KMP (Kotlin Multiplatform) app is a cross-platform application built using modern technologies and libraries. The app allows users to explore various superheroes, view detailed information, and chat with them using an AI-powered chat feature. The app boasts a cool retro look, enhancing the user experience.

<p align="center"> <img alt="API" src="https://img.shields.io/badge/Api%2021+-50f270?logo=android&logoColor=black&style=for-the-badge"/></a> <a href="https://kotlinlang.org"> <img src="https://img.shields.io/badge/Kotlin-2.0.00-blue.svg?style=for-the-badge&logo=kotlin"/> </a> <a href="https://github.com/PalankiBharat/HeroIo/stargazers"> <img src="https://img.shields.io/github/stars/PalankiBharat/HeroIo?color=ffff00&style=for-the-badge"/> </a> <a href="https://hits.sh/github.com/PalankiBharat/HeroIo/"> <img alt="Hits" src="https://hits.sh/github.com/PalankiBharat/HeroIo.svg?style=for-the-badge&label=Views&extraCount=0&color=ff3f6f"/></a> </a> <img alt="GitHub code size in bytes" src="https://img.shields.io/github/languages/code-size/PalankiBharat/HeroIo?style=for-the-badge"> </br> </p>

Features

• Superhero Information: Explore a wide range of superheroes and view detailed information about each one.
• AI Chat: Interact with superheroes through an AI-powered chat feature.
• Retro Design: Enjoy a visually appealing retro-themed user interface.
• Compose Multiplatform: Leverage Jetpack Compose for a modern and declarative UI across Android and other platforms.
• Ktor Client: Utilize Ktor for efficient and scalable network communication.
• Room Database: Store and manage data locally with Room.
• Android ViewModel: Manage UI-related data lifecycle-aware using Android ViewModel.
• Multi-modular Architecture: Follow a multi-modular architecture approach for better code organization and scalability.
• Compose Navigation: Use Compose Navigation with type-safe arguments and shared element transitions.

Technologies Used

• 🌐 Kotlin Multiplatform
• 🖼️ Compose multiplatform
• 🌍 Ktor
• 🗄️ Room
• 📊 Android ViewModel
• 🏗️ Multi-modular Architecture
• 🧭 Compose Navigation

Setting Up Your Own GROQ API Key for AI Chat

This app uses the GROQ API for its AI chat feature. Follow these steps to set up your own API key:

• Go to the GROQ API Console and sign up for an account.
• Obtain your API key from the console.
• Open the data/utils/ApiConstants file in the project directory.
• Add the following line to the file, replacing YOUR_API_KEY with your actual API key:

Screenshots

Video

<div align="center"> </br> <img src="https://github.com/PalankiBharat/HeroIo/blob/master/screenshots/Check%20about%20your%20favrite%20Hero.gif" width="450" height="800" /> </div>

License

Copyright 2024 P N Bharat Kumar

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Acknowledgements

• Superhero API
• Jetpack Compose
• Ktor
• Room