Headlinr is a modern news reader app built using Jetpack Compose Multiplatform, targeting both Android and iOS platforms. It delivers real-time news headlines tailored to the user's country, with the flexibility to search and bookmark favorite articles.
- ✨ Built with Compose Multiplatform for shared UI across Android and iOS.
- 📍 Detects user's current country and fetches headlines accordingly using the MediaStack API.
- 🌐 Allows manual country selection with instant updates to the news feed.
- 💾 Stores selected country locally using Room database.
- 🔎 Supports searching for news within the selected country.
- 📑 View full article details within the app.
- 🌐 Easily open articles in the browser to read more.
- 🔖 Save favorite news to bookmarks for quick access later.
| Layer | Library |
|---|---|
| UI | Compose Multiplatform |
| Dependency Injection | Koin |
| Image Loading | Coil |
| Networking | Ktor Client |
| Persistence | Room |
| Pagination | Multiplatform Paging |
- 📰 Headlines by Country
- 🌍 Country Picker with Flags
- 🔎 Search Results
- 📄 News Detail with Full Article Option
- 🔖 Bookmarks
- Android Studio Giraffe or later
- Kotlin Multiplatform Mobile plugin
- MediaStack API Key
-
Clone the repository:
git clone https://github.com/MuhammetKonukcu/Headlinr.git
-
Add your MediaStack API token to
local.propertiesin the project root:news_auth_token=YOUR_TMDB_API_TOKEN_HERE -
Select Android or iOS simulator
-
Build & run the app
This project is licensed under the MIT License.