Bored Activities App

A simple and modern Android application that suggests random activities for when you're feeling bored, built with Kotlin and Jetpack Compose.

Designed as a clean and minimal example of API consumption, state management, and declarative UI, this project demonstrates best practices in modern Android development using updated architecture components.

Perfect for learning, teaching, or using as a starting point for your own projects involving lightweight network calls and reactive UI.

Features

• Get random activity suggestions with a single tap.
• Refresh to fetch new activities.
• Minimalistic and responsive UI built with Jetpack Compose.

Installation

From Source Code

1. Clone the repository:

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

2. Open the project in Android Studio.

3. Build and run the app on your device or emulator.

Technologies

• Platform & Language: Android, Kotlin.
• Architecture: MVVM, Clean Architecture.
• UI: Jetpack Compose, Material Design.
• Networking & Concurrency: Retrofit, Kotlin Coroutines, Kotlin StateFlow.
• Dependency Injection: Dagger Hilt.

Contributing

Contributions are welcome! If you'd like to improve this project:

1. Fork the repository.

2. Create a new branch:

   git checkout -b feature/new-feature

3. Commit your changes:

   git commit -m 'Add new feature'

4. Push your branch:

   git push origin feature/new-feature

5. Open a Pull Request.

Please ensure your code follows the existing style and includes tests when appropriate.

License

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