https://github.com/birkir/hekla

Hekla for Hacker News (open source React Native app)
https://github.com/birkir/hekla

Last synced: 6 days ago
JSON representation

Hekla for Hacker News (open source React Native app)

• Host: GitHub
• URL: https://github.com/birkir/hekla
• Owner: birkir
• License: mit
• Created: 2018-07-02T14:35:05.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2022-12-06T19:59:26.000Z (about 2 years ago)
• Last Synced: 2024-12-08T05:30:20.857Z (14 days ago)
• Language: TypeScript
• Homepage:
• Size: 13.1 MB
• Stars: 364
• Watchers: 11
• Forks: 75
• Open Issues: 35
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-hacker-news - Hekla

README

        
![dependencies](https://img.shields.io/david/birkir/hekla.svg) ![devDependencies](https://img.shields.io/david/dev/birkir/hekla.svg)



 Hekla for Hacker News



[](https://play.google.com/store/apps/details?id=is.pipe.hekla) [](https://itunes.apple.com/us/app/hekla/id1405096983?mt=8)

iOS and Android client for Hacker News. Inspired by the Apollo client for Reddit.

##### App features:

 - Tabbed interface for easy navigating

 - Browse top stories, newest, show HN, ask HN and jobs

 - Login with your Hacker News account to vote, reply and flag stories

 - Large or compact posts depending on your preference

 - Offline and Travel friendly

 - 3D Touch support

 - iPad support

 - Multiple themes, adjustable font & text size

 - Colour-coded, collapsible comments thread

 - Readability mode/external browser options

##### Beta Screenshots

![iPhone X screenshot of Stories](./assets/screenshots/iphone-x/stories-320w.png) ![iPhone X screenshot of Dark theme](./assets/screenshots/iphone-x/theme-black-320w.png) ![Pixel screenshot of Comments](./assets/screenshots/pixel/comments-320w.png)

## Development features

 - TypeScript

 - Gradle 4

 - Cocoapods

 - CodePush

 - mobx and mobx-state-tree

 - react-native-navigation v2

 - react-native-config

 - JavaScriptCore on Android

 - Keychain to store sensitive data

 - CSS Modules with Stylus

 - patch-package for custom native code

## Getting Started

You will need to grab your own `google-services.json` and `GoogleService-Info.plist`. Head over to firebase.com and create a new application.

You will then need to modify your configuration files to match the Hacker News API:

`./android/app/google-services.json`:

```js

    "firebase_url": "https://hacker-news.firebaseio.com"

```

`./ios/Hekla/GoogleService-Info.plist`

```xml

	DATABASE_URL

	https://hacker-news.firebaseio.com

```

## Contributing

If you are interested in helping out, feel free to submit issues, pull-requests or even [contact me](mailto:[email protected]). I am open to all kind of contributions.

## License

This project is [MIT licensed](/LICENSE.md)