https://github.com/arslan555/galleryon
GalleryOn is a modern Android gallery application built using Kotlin, Jetpack Compose, and a clean MVVM architecture. It offers a fast, beautiful, and customizable way to explore your device's images and videos, supporting both light and dark modes, multiple view layouts (Grid/List) & media details
https://github.com/arslan555/galleryon
android android-gallery clean-architecture-android coroutines-flow dark-mode-theme jetpack-compose jetpack-compose-navigation kotlin material3 mediastore mvi-architecture unit-testing
Last synced: 19 days ago
JSON representation
GalleryOn is a modern Android gallery application built using Kotlin, Jetpack Compose, and a clean MVVM architecture. It offers a fast, beautiful, and customizable way to explore your device's images and videos, supporting both light and dark modes, multiple view layouts (Grid/List) & media details
- Host: GitHub
- URL: https://github.com/arslan555/galleryon
- Owner: arslan555
- Created: 2025-04-25T14:29:05.000Z (25 days ago)
- Default Branch: master
- Last Pushed: 2025-04-28T02:44:27.000Z (22 days ago)
- Last Synced: 2025-04-28T03:29:45.302Z (22 days ago)
- Topics: android, android-gallery, clean-architecture-android, coroutines-flow, dark-mode-theme, jetpack-compose, jetpack-compose-navigation, kotlin, material3, mediastore, mvi-architecture, unit-testing
- Language: Kotlin
- Homepage:
- Size: 24.8 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ⚡ GalleryOn App
GalleryOn is a native Android application built in **Kotlin**, designed to showcase a clean, scalable, and modern approach to building a media gallery. The app uses best practices like modular clean architecture, Jetpack Compose for UI, and robust testing strategies.
## 📝 App Overview
1. **Albums View**
* Displays albums grouped by folders.
* Supports switching between **Grid View** and **List View**.
* Each album shows preview and media count.
2. **Media Listing**
* After selecting an album, displays media items (images/videos) within it.
* Supports basic viewing of media metadata like name, size, and date.
3. **Media Details**
* Displays basic metadata of media items:
* 🖼️ Media
* 📄 Name
* 📏 Size
* 🗓️ Date Taken
4. **Permission Handling**
* Requests appropriate storage permissions at runtime based on Android version.
## 📸 Screenshots
### ☀️ Light Mode
| Launcher Screen | Album Screen (Grid) | Album Screen (List) | Media List Screen | Media Detail Screen |
|:---------------:|:---------------------------------------------------------------------:|:---------------------------------------------------------------------:|:---------------------------------------------------------------:|:----------------------------------------------------------------------:|
| 
| 
| 
| 
| 
|
### 🌙 Dark Mode
| Launcher Screen | Album Screen (Grid) | Album Screen (List) | Media List Screen | Media Detail Screen |
|:---------------:|:-----------------------------------------------------------------------:|:-----------------------------------------------------------------------:|:-----------------------------------------------------------------:|:------------------------------------------------------------------------:|
| 
| 
| 
| 
| 
|
## 🧠 Architecture
🧱 **Clean MVI + Modularized Architecture**
Maintains strict separation of concerns between layers.
### 📁 Module Structure
| Module | Description |
|-------------------------|----------------------------------------------------------|
| `app/` | Application entry point and DI setup. |
| `core/` | Common utilities like permissions management. |
| `domain/` | Business models and use cases (pure Kotlin). |
| `data/` | Repository implementations, media management. |
| `feature/albums/` | Albums screen, view models, UI components. |
| `feature/media/` | Media listing screen, view models, UI components. |
## 🚀 Libraries & Tech Stack
### 🧰 Core Technologies
- **Kotlin** — Modern Android language.
- **Jetpack Compose** — Declarative UI toolkit.
- **Coroutines & Flow** — Async & reactive data streams.
- **Navigation (Compose)** — Type-safe screen navigation.
- **Hilt** — Dependency Injection framework.
### 🧪 Testing Libraries
- **JUnit4** — Unit testing framework.
- **MockK** — Mocks/stubs for testing.
- **Turbine** — Test Kotlin Flow emissions.
## 🧪 Testing Strategy
### 🧷 Unit Tests
- ✅ *ViewModel
- ✅ *Repository
- ✅ *UseCases
All tests utilize `MockK`, `Turbine`, and `Compose Test APIs`.
```bash
./gradlew clean test
```
## 💡 Thought Process
* Adopted a **Clean MVI** architecture to ensure clear separation of concerns and scalable code structure.
* Used **Jetpack Compose** for modern, declarative, and efficient UI development.
* Applied **Dagger-Hilt** for lightweight and easy-to-manage dependency injection.
* Focused heavily on **testability**, **modularization**, and **best Kotlin practices** for long-term maintainability.
## 👨💻 Author
**Mirza Arslan**
📧 [email protected]
🔗 [LinkedIn](https://www.linkedin.com/in/mirza-arslan/)
## 🧭 Final Thoughts
**GalleryOn** showcases a modern Android media application built with a focus on clean architecture, performance, and best development practices.
The project emphasizes modularity, test coverage, scalability, and a smooth user experience.
Feel free to explore it, and suggestions for improvements are always welcome! 🚀