Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nik3212/hackernews

HackerNews is an app for reading Hacker News, built using TCA architecture
https://github.com/nik3212/hackernews

apple applewatch appstore composable-architecture hacker-news hacker-news-client hacker-news-reader hackernews hackernews-client hackers ios ipad ipados iphone news reader swift tca watchos

Last synced: 2 months ago
JSON representation

HackerNews is an app for reading Hacker News, built using TCA architecture

Awesome Lists containing this project

README

        

HackerNews


Licence
CI

![HackerNews: A HackerNews Reader](https://github.com/user-attachments/assets/8a5ba7ae-1e1d-47de-80db-10ed725c5e5e)

## Description
HackerNews is an app for readering Hacker News, built using TCA architecture.

- [Features](#features)
- [Requirements](#requirements)
- [Usage](#usage)
- [Contributing](#contributing)
- [Communication](#communication)
- [Have a Question](#have-a-question)
- [Author](#author)
- [License](#license)

## Features

* View "Top," "Newest," "Best," "Ask," and "Show" posts from Hacker News
* Read posts using the `SFSafariViewController` component
* Full iPad multitasking support
* Utilizes the official [Firebase-based Hacker News API](https://github.com/HackerNews/API)

## Usage

1) Download the repository:
```
$ git clone https://github.com/nik3212/HackerNews
$ cd HackerNews
```

2) Bootstrap the development environment:
```
make bootstrap
```

3) Open the project in Xcode:
```
$ open HackerNews.xcodeproj
```

4) Compile and run the app in your simulator.

## Communication
- If you **found a bug**, open an issue.
- If you **have a feature request**, open an issue.
- If you **want to contribute**, submit a pull request.

# Requirements
- Xcode 15+
- iOS 17+
- Swift 5.9+

## Contributing
Please feel free to help out with this project! If you see something that could be made better or want a new feature, open up an issue or send a Pull Request!

## Have a Question?
Contact us via [issues on GitHub](https://github.com/nik3212/HackerNews/issues).

## Author
Nikita Vasilev, [email protected]

## License

HackerNews is available under the MIT license. See the LICENSE file for more info.