Skip to content

kingg22/vibrion

Repository files navigation

🎵 Vibrion App - Music Showcase — Android Demo App

Kotlin Kotlin Multiplatform Compose Multiplatform Android

GitHub License

Vibrion music app demo built as a technical showcase. This project demonstrates my skills as an Android developer using modern Android architecture and tools.


📱 About the project

Music Showcase is an Android demo application that consumes the public API of Deezer to display music content such as artists, albums, and tracks.

⚠️ Important

This project is NOT intended for production use.

  • ❌ Not published on Google Play
  • ❌ Not distributed to users
  • ❌ No monetization
  • ✅ Code showcase only
  • ✅ Portfolio & technical demonstration

The purpose of this app is to demonstrate:

  • Android / Compose Multiplatform development best practices
  • Clean architecture and modular design
  • Modern UI with Compose, animations, transitions
  • API integration and asynchronous data handling

✨ Features

  • 🔍 Music search (artists, albums, tracks)
  • 🎶 Track listing and previews (API-dependent)
  • 🧭 Modern navigation
  • 🎨 Clean and modern UI using Compose
  • ⚙️ API integration using HTTP client Ktor
  • 🧱 Scalable architecture prepared for growth

🛠️ Tech Stack

  • Language: Kotlin
  • UI: Compose Multiplatform
  • Architecture: Clean Architecture + MVVM
  • Concurrency: Kotlin Coroutines & Flow
  • Networking: HTTP client Ktor consuming Deezer Public API through my client library
  • State handling: Immutable UI state
  • Dependency management: Gradle Version Catalog

🧠 Architecture Overview

The project follows a clean and layered architecture:

data/
├── remote (API through client lib)
├── repository implementations
domain/
├── models
├── usecases
├── repository
ui/
├── screens
├── components
├── theme

Key goals:

  • Clear separation of concerns
  • Testability
  • Easy maintenance and scalability

🖼️ Screenshots

Screenshots below show the current state of the UI and are part of the technical demonstration.

Home Search Album Notification Search 2

(Screenshots will be updated as the UI evolves)


🔑 API Disclaimer

This app uses the public endpoints of Deezer provided by my client library.

  • No private or authenticated endpoints are used
  • All data belongs to Deezer and its respective owners
  • This project is not affiliated with Deezer in any way

📜 Disclaimer

This repository is a personal demo project created exclusively for educational and portfolio purposes.

  • Not affiliated with Deezer
  • No commercial intent
  • No guarantee of API availability or stability

🚀 Why this project exists

I built this app to:

  • Showcase my Android development skills
  • Apply modern Android patterns and tools
  • Experiment with UI/UX decisions
  • Serve as a real-world reference project

📄 License

This project is licensed under the GNU 2.0 License See the LICENSE file for more details.

About

Showcase music app

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages