Repository files navigation

Hacker News readers asProgressive Web Apps. A spiritual successor toTodoMVC.

See oursite or thesite/apps directory for the currentlist of implementations.

Each implementation must include:

• Views: Hacker News Top Stories, New, Show, Ask, Jobs & threaded Comments
  • Each of these should use routing to enable sharability. For reference, see thePreactHN implementation.
• App must display 30 items per-page for story list views
• App must be aProgressive Web App
• App must score over a 90/100 usingLighthouse
• App must aim to be interactive in under 5 seconds on a Moto G4 over 3G. UseWebPageTest using the auto-selected Moto G4 + Faster 3G setting to validate "Time to interactive"
  • We look at numeric Lighthouse scores for TTI as well as a manual inspection of the application's Timeline "trace" andFilmstrip as a sanity check.
• App must use theApplication Shell pattern to instantly load the skeleton of the UI on repeat visits
• App is responsive on desktop and mobile, making best use of available screen real-estate. SeeVue HN as an example.
• App must do its best to work cross-browser

Optionally:

• App supports offline caching of HN data (e.g similar to the 'Offline Mode' in ReactHN)
• App may use server-side rendering so displaying content is resilient to JS not loading on the network

User interface:

• At this time, HNPWA does not prescribe a specific stylesheet or theme for implementations. We will be aiming to provide this in the near future similar to how we do with TodoMVC.

• Official real-time Hacker News API powered by Firebase
• Unofficial Hacker News API by cheeaun

If using the Firebase powered API please use 30 stories per-page to ensure consistency between implementations using the Unofficial API as well as the actualHacker News website

• Emerging Markets: Chrome Beta on a Motorola G (gen 4) tested from Dulles, Virginia on a 400 Kbps 3G connection with 400ms of latency. Tested withWebPageTest using the auto-selected Moto G4 + Emerging Markets setting.
• Faster 3G: Chrome Beta on a Motorola G (gen 4) tested from Dulles, Virginia on a 1.6 Mbps 3G connection with 300ms of latency. Tested withWebPageTest using the auto-selected Moto G4 + Faster 3G setting.
• Time to Interactive readings taken from linked Lighthouse results in WebPageTest.

Each implementation preserves the license noted in the linked to applications.