Splashnt

A wallpaper browser and setter app for Android, built with Jetpack Compose. Browse wallpapers from Unsplash (default, no API key required) or Pexels — switchable in-app.

Features

• Browse wallpapers — Staggered grid layout with infinite scroll pagination and pull-to-refresh
• Switch sources — A pill in the header opens a bottom-sheet picker to swap between Unsplash and Pexels; the grid and category chips reload for the chosen provider
• Filter by category — Chip row above the grid lets you scope the feed to the provider's featured categories (Unsplash topics or Pexels collections)
• Full-screen viewer — Pinch-to-zoom (1x–5x), pan with clamped boundaries, double-tap to toggle fit/fill
• Photographer details — Tap to reveal an animated overlay with photographer name and profile link
• Download — Save images to Pictures/Splashnt via DownloadManager with notification progress
• Set as wallpaper — Apply images to home screen, lock screen, or both via WallpaperManager
• Material You — Dynamic theming with Material 3 expressive components

Tech Stack

Layer	Libraries
UI	Jetpack Compose, Material 3, Navigation 3
Networking	Ktor (Android engine)
Image Loading	Coil 3
Serialization	kotlinx.serialization
DI	Koin

All libraries are chosen for Kotlin Multiplatform compatibility.

Setup

No API key needed for the default Unsplash source. Just build and run:

./gradlew assembleDebug

The app hits Unsplash's unofficial napi endpoint (the same one their website uses). Premium (Unsplash+) photos are filtered out at the repository layer since they aren't downloadable without a paid account.

Pexels (optional): To use the Pexels source (switchable from the header's source picker), add a free Pexels API key to local.properties (git-ignored). Without a key the app still builds and runs on Unsplash; switching to Pexels just lands on an error state.

PEXELS_API_KEY=your_key_here

Requirements: Android Studio, minSdk 31 (Android 12+), targetSdk 36

Architecture

Single-module MVVM app with clean separation between data and UI layers.

app/src/main/java/com/ava/splashnt/
├── data/
│   ├── model/          # Domain types (Wallpaper, Topic) + per-provider DTOs (Unsplash*, Pexels*)
│   ├── mapper/         # DTO → domain extension functions (UnsplashMapper, PexelsMapper)
│   ├── remote/         # Shared Ktor client factory + per-provider API clients (Unsplash, Pexels)
│   └── repository/     # WallpaperRepository interface + Unsplash/Pexels impls, picked by WallpaperRepositoryProvider
├── di/                 # Koin dependency injection modules
└── ui/
    ├── home/           # Staggered grid + topic chip row + source picker + ViewModel with pagination
    ├── detail/         # Full-screen viewer with gestures + overlays
    ├── common/         # Reusable composables (CenteredLoader, SpringyTextButton)
    └── theme/          # Material You theming

See docs/architecture.md for Mermaid class/flow diagrams of the data layer, UI state model, and navigation (renders inline on GitHub).

Roadmap

• Additional sources — Provider abstraction complete: provider-neutral domain models (Wallpaper, Topic), Pexels as a sibling PexelsWallpaperRepository, and in-app source switching via the bottom-sheet picker; next candidate source is Wallhaven
• Polish — Search, wallpaper crop preview before applying (via WallpaperManager.getCropAndSetWallpaperIntent), collapsing header on scroll, home screen design polish (top bar, wordmark subtitle), shared element transitions

License

This project is for educational purposes.