NewsPulse

Deliver a news feed based on each user’s selected categories and notify them of new publications through browser notifications.

The repository organizes three parts: a Vue frontend, an Express backend and an administrative CLI. Registration, login, preferences and feed reading live in the application; the CLI submits news to the API.

MongoDB stores users and news through Mongoose. Middleware validates JWTs received in cookies or Bearer tokens. The feed queries news whose categories match user preferences.

On publication, the API saves the news item, finds matching subscriptions and dispatches Web Push. The service worker displays the notification and opens its destination when selected.

Separating publishing into a CLI reduces the administrative interface needed. Category preferences enable direct filtering without a recommendation system.

Push dispatch uses Promise.allSettled to process multiple subscriptions. Individual failures are logged, but this flow has no persistent retry queue. The returned count represents selected recipients, not confirmed delivery.

No automated suite was found: backend and CLI test scripts are placeholders that exit with an error. Review covered the news controller, middleware, feed and service worker without publishing news or sending notifications.

This is a prototype without evidence of production operation. Publishing middleware requires a matching administrative secret only when ADMIN_SECRET is configured; that configuration needs review before any exposure.

Configuration is coupled to the local environment, and documentation contains some old absolute paths. The frontend manifest requires a newer Node version than the README minimum; use package.json as the reference.

Clone the indicated revision and read the MongoDB, JWT, VAPID and ADMIN_SECRET configuration documentation. Use Node compatible with the frontend manifest and configure your own local credentials.

From the repository root, the commands below install all three parts and build the interface. To run, follow the guide using separate terminals for node app.js in backend and npm run dev in frontend. The CLI and push delivery were not executed in this review.