https://github.com/housseindjirdeh/angular2-hn

:boom: Progressive Hacker News client built with Angular
https://github.com/housseindjirdeh/angular2-hn

angular offline progressive-web-app service-worker

Last synced: about 2 months ago
JSON representation

:boom: Progressive Hacker News client built with Angular

• Host: GitHub
• URL: https://github.com/housseindjirdeh/angular2-hn
• Owner: housseindjirdeh
• License: mit
• Created: 2016-09-03T05:37:07.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2023-01-05T07:16:09.000Z (over 1 year ago)
• Last Synced: 2024-04-14T13:15:30.671Z (5 months ago)
• Topics: angular, offline, progressive-web-app, service-worker
• Language: TypeScript
• Homepage: https://angular2-hn.firebaseapp.com
• Size: 3.51 MB
• Stars: 1,299
• Watchers: 54
• Forks: 234
• Open Issues: 30
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        


  

    

  





  A progressive Hacker News client built with Angular





  View App





  

  



---

:zap: **Fast:** Service Worker App Shell + Dynamic Content model to achieve faster load times with and without a network.

:iphone: **Responsive:** Completely responsive UI that can be installed to your mobile home screen to provide a native feel.

:rocket: **Progressive:** [Lighthouse](https://github.com/GoogleChrome/lighthouse) score of 87/100.



  



## Mobile Preview



  



## Laptop Preview



  



## Offline Support

This app uses [Workbox](https://workboxjs.org/) to generate a service worker as part of the build step to load quickly and work offline.

## Manifest

With Chromium based browsers for Android (Chrome, Opera, etc...), Angular 2 HN includes a Web App Manifest that allows you to install to your homescreen.



  



## Themes

Built in theme engine!

Current themes:

* Default

* Night

* Black (AMOLED)

More to come!

## Areas of improvement

 - Realtime updating using the Firebase SDK (may need to add option to settings so service worker can still rely on REST endpoints)

 - Server side rendering

Feel free to send me feedback on [twitter](https://twitter.com/hdjirdeh) or [file an issue](https://github.com/hdjirdeh/angular2-hn/issues/new)! Feature requests are always welcome.

## Build process

Note: This project has been ejected (with AOT + production settings) in order to customize Webpack configurations.

 - Clone or download the repo

 - `npm install`

 - `npm start` to run the application with webpack-dev-server or `npm build` to kick off a fresh build and update the output directory (`dist/`)

Note: Any Service Worker changes will not be reflected when you run the application locally in development. To test service worker changes:

 - `npm build`

 - `npm run precache` to generate the service worker file

 - `npm run static-serve` to load the application along with the service worker asset using [live-server](https://github.com/tapio/live-server)

## Contributors

A million thanks to some awesome people :)

* [Ashwin Sureshkumar](https://github.com/ashwin-sureshkumar)

* [Mateusz](https://github.com/mateuszwitkowski)

* [Jordi Collell](https://github.com/jordic)

* [Ben Brooks](https://github.com/bbrks)

* [Zach Berger](https://github.com/zachberger)

* [blAck PR](https://github.com/blackpr)

* [Bram Borggreve](https://github.com/beeman)

* [Antonio Indrianjafy](https://github.com/Antogin)

* [Addy Osmani](https://github.com/addyosmani)

* [Majid Hajian](https://github.com/mhadaily)

* [Jeff Cross](https://github.com/jeffbcross)

* [Minko Gechev](https://github.com/mgechev)