{"id":28289250,"url":"https://github.com/muhammetkonukcu/headlinr","last_synced_at":"2026-05-18T00:02:32.482Z","repository":{"id":292170231,"uuid":"979438409","full_name":"MuhammetKonukcu/Headlinr","owner":"MuhammetKonukcu","description":"Headlinr is a modern news reader app built using Jetpack Compose Multiplatform. It delivers real-time news headlines tailored to the user's country.","archived":false,"fork":false,"pushed_at":"2025-05-11T08:33:24.000Z","size":9556,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-09T06:35:52.759Z","etag":null,"topics":["android-application","compose-multiplatform","iosappdevelopment","jetpack-compose","kotlin","kotlin-android","kotlin-multiplatform","mediastack","mediastackapi","newsapp"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MuhammetKonukcu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-07T14:07:32.000Z","updated_at":"2025-07-29T12:15:59.000Z","dependencies_parsed_at":"2025-06-13T04:32:01.338Z","dependency_job_id":"6aba7fbf-eb75-470e-8a7b-59bb9b0a08d2","html_url":"https://github.com/MuhammetKonukcu/Headlinr","commit_stats":null,"previous_names":["muhammetkonukcu/headlinr"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MuhammetKonukcu/Headlinr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuhammetKonukcu%2FHeadlinr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuhammetKonukcu%2FHeadlinr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuhammetKonukcu%2FHeadlinr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuhammetKonukcu%2FHeadlinr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MuhammetKonukcu","download_url":"https://codeload.github.com/MuhammetKonukcu/Headlinr/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuhammetKonukcu%2FHeadlinr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33160167,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"ssl_error","status_checked_at":"2026-05-17T22:39:10.741Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android-application","compose-multiplatform","iosappdevelopment","jetpack-compose","kotlin","kotlin-android","kotlin-multiplatform","mediastack","mediastackapi","newsapp"],"created_at":"2025-05-22T01:11:13.879Z","updated_at":"2026-05-18T00:02:27.473Z","avatar_url":"https://github.com/MuhammetKonukcu.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📰 Headlinr\n\n**Headlinr** is a modern news reader app built using **Jetpack Compose Multiplatform**, targeting\nboth **Android** and **iOS** platforms. It delivers real-time news headlines tailored to the user's\ncountry, with the flexibility to search and bookmark favorite articles.\n\n---\n\n## Screenshots\n\n![First SS](screenshot/first.png)\n\n![Second SS](screenshot/second.png)\n\n## 🌍 Features\n\n- ✨ Built with **Compose Multiplatform** for shared UI across Android and iOS.\n- 📍 Detects user's **current country** and fetches headlines accordingly using\n  the [MediaStack API](https://mediastack.com/).\n- 🌐 Allows **manual country selection** with instant updates to the news feed.\n- 💾 Stores selected country locally using **Room database**.\n- 🔎 Supports **searching** for news within the selected country.\n- 📑 View **full article details** within the app.\n- 🌐 Easily **open articles in the browser** to read more.\n- 🔖 Save favorite news to **bookmarks** for quick access later.\n\n---\n\n## 🛠 Tech Stack\n\n| Layer                | Library                                                                  |\n|----------------------|--------------------------------------------------------------------------|\n| UI                   | Compose Multiplatform                                                    |\n| Dependency Injection | [Koin](https://insert-koin.io/)                                          |\n| Image Loading        | [Coil](https://coil-kt.github.io/coil/)                                  |\n| Networking           | [Ktor Client](https://ktor.io/)                                          |\n| Persistence          | [Room](https://developer.android.com/jetpack/androidx/releases/room)     |\n| Pagination           | [Multiplatform Paging](https://github.com/cashapp/multiplatform-paging) |\n\n---\n\n## 📱 Screens\n\n- 📰 Headlines by Country\n- 🌍 Country Picker with Flags\n- 🔎 Search Results\n- 📄 News Detail with Full Article Option\n- 🔖 Bookmarks\n\n---\n\n## 🏁 Getting Started\n\n### Prerequisites\n\n- Android Studio Giraffe or later\n- Kotlin Multiplatform Mobile plugin\n- MediaStack API Key\n\n## ⚙️ Setup\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/MuhammetKonukcu/Headlinr.git\n   ```\n2. Add your MediaStack API token to `local.properties` in the project root:\n\n   ```properties\n   news_auth_token=YOUR_TMDB_API_TOKEN_HERE\n   ```\n\n3. Select Android or iOS simulator\n\n4. Build \u0026 run the app\n\n## 📄 License\n\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuhammetkonukcu%2Fheadlinr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuhammetkonukcu%2Fheadlinr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuhammetkonukcu%2Fheadlinr/lists"}