An open API service indexing awesome lists of open source software.

https://github.com/cabovianco/android-bored-sample

A simple Android app that suggests activities to do when you're bored, built with Kotlin and Jetpack Compose.
https://github.com/cabovianco/android-bored-sample

android android-sample clean-architecture dagger-hilt jetpack-compose kotlin kotlin-coroutines kotlin-stateflow mvvm retrofit

Last synced: 8 months ago
JSON representation

A simple Android app that suggests activities to do when you're bored, built with Kotlin and Jetpack Compose.

Awesome Lists containing this project

README

          

# Bored Activities App

A simple Android app that suggests activities to do when you're bored, built with Kotlin and Jetpack Compose.

## Description

This project is an example Android application that fetches and displays random activities to help users find something interesting to do when they're bored. It demonstrates modern Android development practices using Kotlin and Jetpack Compose.

## Features

- Get random activity suggestions
- Refresh to get new activities
- Simple and clean UI

## Technologies Used

- **Kotlin**: Primary programming language with Coroutines for asynchronous programming
- **Jetpack Compose**: Declarative UI toolkit with Material Design components
- **Android Architecture Components**: ViewModel, StateFlow for UI state management
- **Retrofit**: Type-safe HTTP client for Android, used for networking and API calls
- **Dagger-Hilt**: Dependency injection framework

## Installation

1. Clone the repository:
```bash
git clone https://github.com/cabovianco/android-bored-sample.git
```
2. Open the project in Android Studio
3. Sync the project with Gradle
4. Run the application on a device or emulator

## Contributing

Contributions are welcome. Feel free to open issues or submit pull requests to improve the application.

## License

This project is licensed under the MIT License.