hn.minimal

a minimal Hacker News client tailored to my reading habits 🪡

• stories do not shift over time as you navigate through pages ⚓️
• select interesting stories first, then open them all in tabs for reading ✏️
• keyboard controls ⌨️

Note: This is a little side-project I dabbled in with half a 🧠 for some exploration and prototyping. It does not quite reflect the amount of care I would pour into any serious project.

Prerequisites

Be sure to have a recent version of Node.js installed (i.e. Node.js 16+).

Getting started

To install dependencies, run:

npm install

Then, to start the development server:

npm start

Open your browser and point it to the server address.

Development tasks

To run the tests:

npm test            # or:
npm test -- --watch # to automatically re-run whenever a file changes

Test data generation is randomized. When you encounter a test failure, use the SEED value printed at the start of the test run to reproduce it: SEED=… npm test.

To check code for consistent formatting and potential issues:

npm run lint

References

• Hacker News API: https://github.com/HackerNews/API