← back to gallery

Dev Pain Index

Real-time frustration leaderboard tracking what breaks developers this week

researchdevreldeveloper-experiencesentimenthacker-newsdevto
Open product ↗

Dev Pain Index

A real-time developer frustration leaderboard that scrapes Hacker News and Dev.to to surface which tools, languages, and platforms are causing the most pain right now. Built for DevRel leads and product managers who need to spot brewing frustrations before they become PR crises.

What it does

Data Sources

| Source | URL | Refresh Interval | What's Extracted |
|--------|-----|-------------------|------------------|
| HN Algolia Stories | https://hn.algolia.com/api/v1/search?tags=story | Every 10 minutes | Stories with frustration keywords in title. Rotates through 3 keywords per cycle. |
| HN Algolia Comments | https://hn.algolia.com/api/v1/search_by_date?tags=comment | Every 10 minutes | Recent comments mentioning developer tools in frustration contexts. Rotates through 4 keywords per cycle. |
| Dev.to Articles | https://dev.to/api/articles?tag={tag}&top=7 | Every hour | Articles from discuss, watercooler, healthydebate, javascript, webdev, python, devops, programming tags. |

All APIs are free and require no API keys.

Scoring Formula

mention_pain_score = keyword_intensity * (1 + log2(1 + source_points)) * recency_decay

API Endpoints

| Method | Path | Description |
|--------|------|-------------|
| GET | /dev-pain-index/health | Health check with last scrape time and mention count |
| GET | /dev-pain-index/api/stats | Dashboard stats: mentions today, tools tracked, most painful category, scraper statuses |
| GET | /dev-pain-index/api/leaderboard?category=&period=24h\|7d | Ranked tools with pain scores, sparklines. Optional category filter. |
| GET | /dev-pain-index/api/categories | All 5 categories with aggregate scores and 7-day trend arrays |
| GET | /dev-pain-index/api/tools/:slug | Tool detail: timeline, recent mentions, rank |
| GET | /dev-pain-index/api/mentions?tool=&limit=20&offset=0 | Paginated raw mentions for a tool |
| GET | /dev-pain-index/api/report/weekly | Weekly report: top 5 tools with deltas, category breakdown |

Running Locally

npm install
PORT=4744 node server.js

Open http://localhost:4744/dev-pain-index/ in your browser. Scrapers run immediately on startup and then on their scheduled intervals.

Tech Stack

Classification

Tools are classified into 5 categories based on a dictionary of ~100 known developer tools:
- tooling: build tools, editors, CI/CD, package managers
- language: programming languages, frameworks
- platform: cloud providers, hosting, databases
- process: project management, workflows
- ai: AI tools, copilots, LLMs