Migrate from markdown-link-check to lychee

.github/workflows/check-markdown-links.yml

@@ -6,12 +6,12 @@ on:
     paths:
       - '**.md'
       - '.github/workflows/check-markdown-links.yml'
-      - '.github/markdown-link-check-config.json'
+      - '.lychee.toml'
   pull_request:
     paths:
       - '**.md'
       - '.github/workflows/check-markdown-links.yml'
-      - '.github/markdown-link-check-config.json'
+      - '.lychee.toml'
   schedule:
     # Run weekly on Monday at 8am UTC
     - cron: '0 8 * * 1'
@@ -23,18 +23,15 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Check markdown links (with retry on transient errors)
-        uses: Wandalen/wretry.action@v3.5.0
+      - name: Restore lychee cache
+        uses: actions/cache@v4
         with:
-          action: tcort/github-action-markdown-link-check@a800ad5f1c35bf61987946fd31c15726a1c9f2ba
-          with: |
-            use-quiet-mode: yes
-            use-verbose-mode: no
-            config-file: .github/markdown-link-check-config.json
-            folder-path: docs/
-            file-extension: .md
-            max-depth: -1
-            check-modified-files-only: no
-            base-branch: master
-          attempt_limit: 3
-          attempt_delay: 10000
+          path: .lycheecache
+          key: cache-lychee-${{ github.sha }}
+          restore-keys: cache-lychee-
+
+      - name: Check markdown links
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: --config .lychee.toml docs/ *.md react_on_rails_pro/docs/ react_on_rails_pro/*.md
+          fail: true

.gitignore

@@ -91,3 +91,4 @@ packages/**/node_modules/
 
 # Jest test reports
 junit.xml
+.lycheecache

.lychee.toml

@@ -0,0 +1,57 @@
+# Lychee link checker configuration
+# https://lychee.cli.rs
+
+# Accept successful responses and permanent redirects
+# 200 = OK, 308 = Permanent Redirect
+accept = ["200", "308"]
+
+# Retry failed requests (handles transient 502/503/504/429 errors)
+max_retries = 4
+retry_wait_time = 15
+
+# Timeout for each request
+timeout = 20
+
+# Exclude patterns (migrated from markdown-link-check-config.json)
+exclude = [
+  # Localhost/development URLs
+  '^http://localhost',
+  '^https://localhost',
+  '^mailto:',
+
+  # Sites that block bots or require auth
+  '^https://www\.npmjs\.(org|com)',
+  '^https://medium\.com',  # Returns 403 for automated requests
+  '^https://www\.linkedin\.com',
+  '^https://reactrails\.slack\.com',
+  '^https://docs\.google\.com',  # Private docs require auth
+  '^https://claude\.ai',  # Returns 403 for automated requests
+
+  # Known dead/problematic URLs (verified)
+  '^https://your-shared-addr\.c9users\.io',
+  '^https://hichee\.com',
+  '^https?://rubyonrails\.org/doctrine',  # DNS issues
+
+  # Sites from PROJECTS.md that block bots or are unreliable
+  '^https://blog\.shakacode\.com',  # May block automated requests
+  '^https?://(www\.)?foxford\.ru',  # Russian site, often blocks bots
+  '^https://(www\.)?airgoat\.com',  # Returns 403
+  '^https://(www\.)?first\.io',     # Returns 403
+  '^https://(www\.)?estately\.com', # Returns 403
+  '^https://hiring\.careerbuilder\.com',  # Returns 403
+]
+
+# Exclude paths (regex patterns)
+exclude_path = [
+  'docs/planning/',           # Contains placeholder links
+  '.*/node_modules/.*',       # Dependencies
+  '.*/spec/.*',               # Test fixtures
+  'SUMMARY.md',               # GitBook TOC with old doc structure links (kept for redirects)
+]
+
+# Don't check fragments/anchors (can be flaky)
+include_fragments = false
+
+# Cache results to speed up repeated runs
+cache = true
+max_cache_age = "1d"

PROJECTS.md

@@ -41,11 +41,10 @@ _Please support the project by [emailing Justin Gordon](mailto:justin@shakacode.
 
 - [github.com/empirical-org/Empirical-Core](https://github.com/empirical-org/Empirical-Core): [Quill.org](https://quill.org/) Provides free tools to make your students better writers.
 - **[Coderwall](https://coderwall.com/)**: The latest development and design tips, tools, and projects from our developer community. Source at [github.com/coderwall/coderwall-next](https://github.com/coderwall/coderwall-next)
-- [department-of-veterans-affairs/caseflow](https://github.com/department-of-veterans-affairs/caseflow): Caseflow is a web application that enables the tracking and processing of appealed claims at the Board of Veterans' Appeals.
 
 ## Demos and Tutorials
 
-- [reactrails.com](http://www.reactrails.com), source code [github.com/shakacode/react-webpack-rails-tutorial](https://github.com/shakacode/react-webpack-rails-tutorial/)
+- [reactrails.com](https://reactrails.com), source code [github.com/shakacode/react-webpack-rails-tutorial](https://github.com/shakacode/react-webpack-rails-tutorial/)
 - [Relay Rails Blog](https://github.com/gauravtiwari/relay-rails-blog): Tutorial to learn Relay with Rails.
 - [Hot Module Replacement with react_on_rails](https://medium.com/@hrishio/lesson-5-hot-module-replacement-for-react-in-rails-using-the-react-on-rails-gem-643c5b01f3d7#.ehevxok16) : Step-by-step tutorial for a quick basic set up of hot asset reloading with HMR in a Rails 5 app. [Code on Github](https://github.com/learnetto/calreact-hmr).....
 

react_on_rails_pro/CHANGELOG.md

@@ -102,7 +102,7 @@ Changes since the last non-beta release.
   - Seamlessly use React Server Components in your Rails apps
   - Reduce client bundle sizes
   - Enable powerful new patterns for data fetching
-  - [See the full tutorial](https://www.shakacode.com/react-on-rails-pro/docs/react-server-components-tutorial)
+  - [See the full tutorial](https://www.shakacode.com/react-on-rails-pro/docs/react-server-components/tutorial)
 
 [PR 422](https://github.com/shakacode/react_on_rails_pro/pull/422) by [AbanoubGhadban](https://github.com/AbanoubGhadban).