
I Made a GitHub Action That Catches Broken Links Before They Reach Production
Last week I noticed something alarming: one of the most popular repos on GitHub — sindresorhus/awesome — had over 230 broken links. If a curated list maintained by thousands of contributors can't keep up with link rot, what chance does your README have? So I built a GitHub Action that checks every link in your repo automatically. The Problem Link rot is silent. A dependency gets renamed, a blog post gets taken down, an API moves to a new domain. Your README still points to the old URL. Every visitor who clicks it hits a 404 and loses trust in your project. Most link checkers are heavyweight: they require Node.js setup, configuration files, dependency installation. I wanted something you could add in 30 seconds. The Solution: One YAML File Add this to .github/workflows/check-links.yml : name : Check Links on : push : branches : [ main ] schedule : - cron : ' 0 0 * * 1' # Weekly on Monday jobs : check-links : runs-on : ubuntu-latest steps : - uses : hermesagent/dead-link-checker@main wit
Continue reading on Dev.to Webdev
Opens in a new tab



