Research systems

    Newsdesk.

    A calm reader for Indian and global market news. The same story from many publishers is shown once, with key points taken from the article.

    Today
    01Overview

    What it is.

    Newsdesk is a calm, fast reader for Indian and global market news.

    It pulls headlines from 30+ publications, merges the same event reported by many outlets into one Story, and lets you read clean key points instead of ad-heavy pages. Everything runs on your own machine: a small Express server collects the feeds into SQLite (30-day history) and a React app shows them. Summaries are extracted sentences from the article itself (TextRank), not AI-written text, so nothing is invented.

    Built with
    • React 18
    • Vite
    • Tailwind
    • Express
    • SQLite (better-sqlite3)
    • fast-xml-parser
    LicencePolyForm Noncommercial 1.0.0
    03Get it running

    Get it running.

    Let an AI do it for you

    Claude

    Best when you want architecture explanation, codebase understanding, and a clean implementation plan before edits.

    You need: Repo access, README context, Terminal if using Claude Code.

    How to use: Paste the prompt with the GitHub link. Ask Claude to read the README, map modules, list risks, and produce a practical plan before using Claude Code or another agent to implement.

    You are my setup assistant. Install and run "Newsdesk" on my computer, then confirm it works. I am not a developer, so explain every step in simple English.
    
    Repository: https://github.com/MrChartist/Newsdesk
    What it is: A calm reader for Indian and global market news. The same story from many publishers is shown once, with key points taken from the article.
    Built with: React 18 + Vite + Tailwind + Express + SQLite (better-sqlite3) + fast-xml-parser
    
    Rules
    1. Ask which operating system I use (Windows, macOS or Linux) and give commands for that system only.
    2. Check what is already installed (Git, Node.js or Python versions) before installing anything. If something is missing, tell me where to download it and wait.
    3. Ask me before installing anything globally or changing system settings.
    4. Never ask me to paste passwords or API keys into this chat. If a key is needed, tell me which file to put it in.
    5. Do not edit the project's source code unless I ask.
    6. Read the README first. If it disagrees with the steps below, follow the README and tell me why.
    
    Steps from the guide
    1. Install Node.js 18 or higher (nodejs.org).
    2. Clone: git clone https://github.com/MrChartist/newsdesk.git && cd newsdesk
    3. Install: npm install
    4. Run both frontend and backend: npm start
    5. Open http://localhost:5185 for the app. The backend API runs on http://localhost:3001 (check http://localhost:3001/api/health).
    6. Run the tests: npm test (checks the SSRF guard, the TextRank summariser, the company mapper and story clustering).
    7. For a build: npm run build, then run the backend with npm run backend and serve the dist folder from any static host or reverse proxy.
    
    When the steps are done
    - Start the app and tell me the exact address to open. Expected address: http://localhost:5185
    - If an error appears, read it, fix the cause and retry. After three failed attempts, stop and explain the problem simply.
    - Finish with five short lines: what the app does, how to start it again, how to stop it, where its data is stored, and one thing I can try first.
    - This is an information tool. It is not investment advice.
    
    If you can run a terminal (Claude Code), do it yourself. If you are chat only, give me one command block at a time and wait for me to reply before the next.

    Or run it yourself

    You need Node.js 18 or higher; git; about 3 minutes; internet (to fetch feeds).

    Open a terminal and run
    git clone https://github.com/MrChartist/newsdesk.gitcd newsdesknpm installnpm start
    Then open http://localhost:5185 in your browser.
    04FAQ

    Questions about Newsdesk.

    Best next step

    Run it, then read the code.

    Run npm start, open localhost:5185, read one story in the reader, then ask an AI to trace how feeds become Stories (backend/feedProxy.js and src/lib/stories.ts) before changing anything.

    Privacy settings

    Essential sign-in storage and your saved preferences stay enabled. Analytics is optional, and you can change your choice anytime.

    Turning analytics off clears our analytics cookies and local assistant metrics. The page reloads to stop a previously loaded analytics service. Your account and learning progress stay saved.

    Read the Privacy Policy