Automated link checking on a Hugo site with Lychee and Gitea Actions

Tue, 23 Jun 2026 00:00:00 +0000

Introduction ¶

Broken links on a static site are easy to miss. You rename a post, change a slug, or just forget to update a reference somewhere, and suddenly you have a 404 sitting there for weeks until someone actually mentions it. I wanted to catch those automatically on every push, not find out about them later.

Lychee is a fast, async link checker written in Rust. It can check internal links without making any network requests (working entirely against the built HTML files), and it checks external links against live URLs too. Both checks run as steps in a Gitea Actions workflow on every push to main or dev, and on every pull request.

Deploying a Hugo site on Gitea to Cloudflare Pages with Gitea Actions

Wed, 27 May 2026 00:00:00 +0000

Introduction ¶

A while back I wrote a post on deploying a Hugo site from Gitea to Cloudflare Pages using a Gitea push mirror to GitHub, because at the time Cloudflare Pages only supported GitHub and GitLab as Git sources. That workaround works but it always felt wrong, two repos to keep in sync, a Personal Access Token to rotate, and a third-party round trip on every commit.

You do not need any of that now. Gitea has Actions, and Cloudflare Pages has direct upload via wrangler . One workflow file in your Gitea repo builds the site and pushes the public folder straight to Pages. No GitHub in the loop.

CI-CD on Jamie Ede

Automated link checking on a Hugo site with Lychee and Gitea Actions

Introduction ¶

Deploying a Hugo site on Gitea to Cloudflare Pages with Gitea Actions

Introduction ¶