https://github.com/inoles/newswave

Kotlin/Compose Multiplatform project to show top news headlines from NewsAPI.
https://github.com/inoles/newswave

android compose-desktop compose-ios compose-multiplatform corountine ios kmp kotlin kotlin-flow kotlin-multiplatform newsapi swift swiftui

Last synced: about 1 month ago
JSON representation

Kotlin/Compose Multiplatform project to show top news headlines from NewsAPI.

• Host: GitHub
• URL: https://github.com/inoles/newswave
• Owner: iNoles
• License: gpl-3.0
• Created: 2023-07-23T00:33:22.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2026-04-27T16:41:57.000Z (about 1 month ago)
• Last Synced: 2026-04-27T18:29:53.594Z (about 1 month ago)
• Topics: android, compose-desktop, compose-ios, compose-multiplatform, corountine, ios, kmp, kotlin, kotlin-flow, kotlin-multiplatform, newsapi, swift, swiftui
• Language: Kotlin
• Homepage:
• Size: 1.7 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# NewsWave 🗞

[![GitHub license](https://img.shields.io/github/license/iNoles/News)](https://github.com/iNoles/News/blob/main/LICENSE)

NewsWave is a simple news application built using Compose Multiplatform that utilizes the NewsAPI to fetch top US news headlines from various sources across seven categories. This app is designed to run seamlessly across Android, iOS, and Desktop platforms.

## Features

- Fetches top news headlines from the NewsAPI.

- Supports browsing news articles from various sources across seven categories.

- Clean and intuitive user interface.

- Responsive design for Android, iOS, and Desktop platforms.

## Supported Platforms

- Android

- iOS

- Desktop

## Prerequisites

- Kotlin and Jetpack Compose knowledge

- Android Studio 4.2 or higher

- Xcode 12 or higher (for iOS development)

- IntelliJ IDEA or Android Studio (for Desktop development)

## Setup

1. Clone this repository.

2. Obtain a NewsAPI key from [NewsAPI](https://newsapi.org/).

3. Add your NewsAPI key to the appropriate location in the project.

4. Build and run the app on your desired platform.

## Getting Started

1. Launch the app.

2. Browse through the top news headlines from various sources.

3. Tap on a news article to read the full story.

## Stack

- 🍎 Shared UI - [Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform)

- 🌎 Network - [Fuel](https://github.com/kittinunf/fuel)

- 🛢 Image Loading - [Coil](https://github.com/coil-kt/coil)



## Contributing

Contributions are welcome! If you would like to contribute to this project, please fork the repository and submit a pull request.