{"id":20075784,"url":"https://github.com/data-miner00/ng-hackernews","last_synced_at":"2026-01-06T23:07:19.273Z","repository":{"id":41110605,"uuid":"438259196","full_name":"data-miner00/ng-hackernews","owner":"data-miner00","description":"Hackernews implementation in Angular","archived":false,"fork":false,"pushed_at":"2024-07-26T22:44:22.000Z","size":4241,"stargazers_count":2,"open_issues_count":6,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-01T22:51:05.807Z","etag":null,"topics":["angular","circleci","hackernews"],"latest_commit_sha":null,"homepage":"https://hn.mumk.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/data-miner00.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-14T13:15:55.000Z","updated_at":"2024-07-26T22:44:23.000Z","dependencies_parsed_at":"2024-03-09T03:23:23.956Z","dependency_job_id":"34def3d2-cfee-445e-8b8d-ce8877ff756b","html_url":"https://github.com/data-miner00/ng-hackernews","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/data-miner00%2Fng-hackernews","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/data-miner00%2Fng-hackernews/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/data-miner00%2Fng-hackernews/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/data-miner00%2Fng-hackernews/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/data-miner00","download_url":"https://codeload.github.com/data-miner00/ng-hackernews/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245921670,"owners_count":20694360,"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":["angular","circleci","hackernews"],"created_at":"2024-11-13T15:00:37.385Z","updated_at":"2026-01-06T23:07:19.268Z","avatar_url":"https://github.com/data-miner00.png","language":"TypeScript","readme":"\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n\u003c!-- PROJECT SHIELDS --\u003e\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ch3 align=\"center\"\u003eThe Hacker Times\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    An Angular implementation of Hackernews with \u003ca href=\"https://www.nytimes.com/\"\u003eNY Times\u003c/a\u003e vibes.\n    \u003cbr /\u003e\n    \u003ca href=\"https://hn.mumk.dev\"\u003e\u003cstrong\u003eView Website »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/data-miner00/ng-hackernews\"\u003eExplore the docs\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/data-miner00/ng-hackernews/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/data-miner00/ng-hackernews/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#built-with\"\u003eBuilt With\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#design\"\u003eDesign\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#roadmap\"\u003eRoadmap\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#acknowledgments\"\u003eAcknowledgments\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\u003e I believe beautiful web apps can be made with Angular too 💕\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n\n## About The Project\n\n![Landing Page](/images/landing-page.png)\n\nA simple implementation of the Hackernews interface in Angular using the official [Hackernews API](https://github.com/HackerNews/API). Save your favourite posts or interesting topics to the read later lists that are stored entirely on your browser.\n\n![Stories List](/images/story-list.png)\n\nThe listing page for **Top Stories**, **Ask Stories**, **Show Stories** and **Job Stories**.\n\n![Story Page](/images/story-page.png)\n\nThe page for an individual story with details and discussions.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n### Built With\n\nThe technologies and tools used in the project.\n\n- Angular\n- Sass\n- TypeScript\n- Jasmine/Karma\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- DESIGN --\u003e\n\n### Design\n\nThere are not much design considerations when it comes to this project and hence very straightforward and simple. The portal itself consumes the data from Hackernews API and persistence via localStorage.\n\n```mermaid\ngraph LR\n    hn[Hackernews API] -- Stories --\u003e Portal\n    localStorage -- Persistence --\u003e Portal\n```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- GETTING STARTED --\u003e\n\n## Getting Started\n\n### Prerequisites\n\nThe list of tools that are used for development.\n\n- npm\n  ```sh\n  npm install npm@latest -g\n  ```\n- [Git](https://git-scm.com/downloads)\n- firebase-tools\n  ```sh\n  npm install -g firebase-tools\n  ```\n\n### Installation\n\nInstallation is fairly straightforward. Just clone the repo and `npm i \u0026\u0026 npm start`.\n\n1. Clone the repo\n   ```sh\n   git clone https://github.com/data-miner00/ng-hackernews.git\n   ```\n2. Install Node dependencies\n   ```sh\n   npm i\n   ```\n3. Recommend to run tests to check if things are breaking\n   ```sh\n   npm test\n   ```\n4. Lint the Sass files\n   ```sh\n   npm run lint:css\n   ```\n5. Start local dev server\n   ```sh\n   npm start\n   ```\n6. Compile for production\n   ```sh\n   npm run build\n   ```\n7. Deployment\n   ```sh\n   firebase deploy\n   ```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- ROADMAP --\u003e\n\n## Roadmap\n\n- [ ] Add Pexels API for image\n- [ ] Use mixin for repeated css\n- [ ] Implement User Page\n- [ ] Add upvote count to comment\n- [ ] Implement random page\n- [ ] Add linter\n- [ ] Improve mobile responsiveness\n- [ ] Use RxJs ShareReplay to **cache results**\n\nSee the [open issues](https://github.com/data-miner00/ng-hackernews/issues) for a full list of proposed features (and known issues).\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- CONTRIBUTING --\u003e\n\n## Contributing\n\n\u003e I am bad at design, please help if you can design it better!\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- LICENSE --\u003e\n\n## License\n\nDistributed under the MIT License. See `LICENSE` for more information.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- ACKNOWLEDGMENTS --\u003e\n\n## Acknowledgments\n\nList of resources that are helpful and would like to give credit to.\n\n- [Using Different Layout Frames For Different Routes In Angular](https://javascript.plainenglish.io/using-different-layout-frames-for-different-routes-in-angular-d96ed096c633)\n- [How to Unit Test an HTTP Service in Angular](https://braydoncoyer.dev/blog/how-to-unit-test-an-http-service-in-angular)\n- [unit-testing for values set async in ngOnInit() function of an angular component](https://stackoverflow.com/questions/44294960/unit-testing-for-values-set-async-in-ngoninit-function-of-an-angular-component)\n- [Angular migration helper](https://update.angular.io/)\n- [Angular Best Practices](https://app.pluralsight.com/library/courses/best-angular-practices/table-of-contents)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\n[contributors-shield]: https://img.shields.io/github/contributors/data-miner00/ng-hackernews.svg?style=for-the-badge\n[contributors-url]: https://github.com/data-miner00/ng-hackernews/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/data-miner00/ng-hackernews.svg?style=for-the-badge\n[forks-url]: https://github.com/data-miner00/ng-hackernews/network/members\n[stars-shield]: https://img.shields.io/github/stars/data-miner00/ng-hackernews.svg?style=for-the-badge\n[stars-url]: https://github.com/data-miner00/ng-hackernews/stargazers\n[issues-shield]: https://img.shields.io/github/issues/data-miner00/ng-hackernews.svg?style=for-the-badge\n[issues-url]: https://github.com/data-miner00/ng-hackernews/issues\n[license-shield]: https://img.shields.io/github/license/data-miner00/ng-hackernews.svg?style=for-the-badge\n[license-url]: https://github.com/data-miner00/ng-hackernews/blob/master/LICENSE\n[product-screenshot]: images/screenshot.png\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdata-miner00%2Fng-hackernews","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdata-miner00%2Fng-hackernews","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdata-miner00%2Fng-hackernews/lists"}