HackerNewsApp is designed to bring the latest stories from Hacker News straight to your Android device, showcasing modern development practices with Kotlin and Jetpack Compose.
- Latest Stories: Displays a continuously updated list of stories from Hacker News.
- Responsive UI: Adapts smoothly across different Android devices using Jetpack Compose.
- External Links: Opens full stories in the default web browser with a single tap.
- Simple Navigation: Seamlessly switch between the main story list and the app information screen.
Built on the MVVM architecture pattern, HackerNewsApp emphasizes a clear separation between its UI, logic layer, and data modeling.
- View: Rendered with Jetpack Compose, ensuring reactive UI updates.
- ViewModel: Manages UI-related data and handles communication between the View and Repository layers.
- Model: Defines the structure for Hacker News stories and other relevant data entities.
To run the HackerNewsApp on your local machine, follow these steps:
- Ensure you have Android Studio installed. You can download it from here.
- Clone this repository to your local machine.
- Open the project with Android Studio.
- Wait for Android Studio to download all the necessary Gradle dependencies.
- Choose an emulator or connect a physical device on which to run the app.
- Run the application through Android Studio.
- Jetpack Compose: For building the UI.
- Retrofit: For network HTTP requests.
- Jetpack Navigation-compose: For in-app navigation.
- Additional dependencies for Material icons, ViewModel, LiveData, Coroutines, etc.
Contributions are welcome! If you'd like to contribute, feel free to create a pull request or open an issue.
Distributed under the MIT License. See LICENSE for more information.
- Special thanks to the Hacker News API for providing stories data.
- Jetpack Compose for revolutionizing UI development on Android.
For any queries, you can reach out to Github and open a PR.