{"id":13401321,"url":"https://github.com/tastejs/hacker-news-pwas","last_synced_at":"2025-03-14T07:31:32.224Z","repository":{"id":41142833,"uuid":"86204319","full_name":"tastejs/hacker-news-pwas","owner":"tastejs","description":"HNPWA - Hacker News readers as Progressive Web Apps 📱","archived":true,"fork":false,"pushed_at":"2020-10-06T12:35:07.000Z","size":19886,"stargazers_count":2376,"open_issues_count":34,"forks_count":207,"subscribers_count":56,"default_branch":"master","last_synced_at":"2024-04-14T12:08:09.712Z","etag":null,"topics":["code-splitting","hacker","hacker-news-reader","lighthouse","news","progressive-web-app","prpl"],"latest_commit_sha":null,"homepage":"https://hnpwa.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tastejs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-03-26T03:21:19.000Z","updated_at":"2024-04-01T01:03:34.000Z","dependencies_parsed_at":"2022-08-10T01:36:32.275Z","dependency_job_id":null,"html_url":"https://github.com/tastejs/hacker-news-pwas","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tastejs%2Fhacker-news-pwas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tastejs%2Fhacker-news-pwas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tastejs%2Fhacker-news-pwas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tastejs%2Fhacker-news-pwas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tastejs","download_url":"https://codeload.github.com/tastejs/hacker-news-pwas/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243541890,"owners_count":20307777,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["code-splitting","hacker","hacker-news-reader","lighthouse","news","progressive-web-app","prpl"],"created_at":"2024-07-30T19:01:01.429Z","updated_at":"2025-03-14T07:31:30.840Z","avatar_url":"https://github.com/tastejs.png","language":"HTML","funding_links":[],"categories":["HTML","Tools"],"sub_categories":["Miscellaneous Utilities"],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://hnpwa.com/\"\u003e\n    \u003cimg src='https://raw.githubusercontent.com/tastejs/hacker-news-pwas/b3f3d40b9e4bd385dbb973d238ce207aed1f60eb/media/logo.png' width='400px'/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Hacker News readers as  \u003ca href=\"https://g.co/ProgressiveWebApps\"\u003eProgressive Web Apps\u003c/a\u003e. A spiritual successor to \u003ca href=\"https://github.com/tastejs/todomvc\"\u003eTodoMVC\u003c/a\u003e.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://travis-ci.org/tastejs/hacker-news-pwas\"\u003e\u003cimg alt=\"Build Status\" src=\"https://travis-ci.org/tastejs/hacker-news-pwas.svg?branch=master\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Implementations\n\nSee our [site](https://hnpwa.com/) or the `site/apps` directory for the current\nlist of implementations. \n\n## Specification\n\nEach implementation must include:\n\n* Views: Hacker News Top Stories, New, Show, Ask, Jobs \u0026 threaded Comments\n  * Each of these should use routing to enable sharability. For reference, see the [PreactHN](https://hn.kristoferbaxter.com/) implementation.\n* App must display 30 items per-page for story list views\n* App must be a [Progressive Web App](https://g.co/ProgressiveWebApps)\n* App must score over a 90/100 using [Lighthouse](https://github.com/GoogleChrome/lighthouse)\n* App must aim to be interactive in under 5 seconds on a Moto G4 over 3G. Use [WebPageTest](https://www.webpagetest.org/easy) using the auto-selected Moto G4 + Faster 3G setting to validate \"Time to interactive\"\n  * We look at numeric Lighthouse scores for TTI as well as a manual inspection of the application's Timeline \"trace\" and [Filmstrip](https://www.webpagetest.org/video/compare.php?tests=170514_00_bb389f33405b558ea644b37f565c8a56-r:1-c:0) as a sanity check.\n* App must use the [Application Shell](https://developers.google.com/web/fundamentals/architecture/app-shell) pattern to instantly load the skeleton of the UI on repeat visits\n* App is responsive on desktop and mobile, making best use of available screen real-estate. See [Vue HN](https://vue-hn.now.sh/top) as an example.\n* App must do its best to work cross-browser\n\nOptionally:\n\n* App supports offline caching of HN data (e.g similar to the 'Offline Mode' in ReactHN)\n* App may use server-side rendering so displaying content is resilient to JS not loading on the network\n\nUser interface:\n\n* 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.\n\n### Data sources\n\n* [Official real-time Hacker News API powered by Firebase](https://github.com/HackerNews/API)\n* [Unofficial Hacker News API](https://github.com/cheeaun/node-hnapi) by cheeaun\n\nIf using the Firebase powered API please use 30 stories per-page to ensure consistency between implementations using the Unofficial API as well as the actual [Hacker News website](https://news.ycombinator.com/)\n\n## Network settings\n\n* 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 with [WebPageTest](https://www.webpagetest.org/easy) using the auto-selected Moto G4 + Emerging Markets setting.\n* 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 with [WebPageTest](https://www.webpagetest.org/easy) using the auto-selected Moto G4 + Faster 3G setting.\n* `Time to Interactive` readings taken from linked Lighthouse results in WebPageTest.\n\n## License\n\nEach implementation preserves the license noted in the linked to applications.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftastejs%2Fhacker-news-pwas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftastejs%2Fhacker-news-pwas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftastejs%2Fhacker-news-pwas/lists"}