From 6beb91d03ce99b30471f84d0dfea9573abb9caa9 Mon Sep 17 00:00:00 2001
From: lex00 <121451605+lex00@users.noreply.github.com>
Date: Sun, 12 Jul 2026 11:45:22 -0600
Subject: [PATCH] docs: lead the README with a link back to the chant docs

Add a prominent line under the tagline pointing to the chant docs and the Fly
deploy tutorial mudflaps powers, so a visitor lands on the product context.
---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 233c2e1..2bd89c0 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,8 @@
 
 A standalone, stateful local emulator of the Fly.io Machines API (flaps). Like LocalStack, but for Fly Machines.
 
+mudflaps is the local target for [chant](https://intentius.io/chant)'s Fly lexicon — its `flyApply` applier deploys against mudflaps for offline, accountless runs. See the [chant docs](https://intentius.io/chant) and the [Fly deploy tutorial](https://intentius.io/chant/tutorials/fly-deploy-rollback/) it powers.
+
 [![CI](https://github.com/intentius/mudflaps/actions/workflows/ci.yml/badge.svg)](https://github.com/intentius/mudflaps/actions/workflows/ci.yml)
 [![Go Reference](https://pkg.go.dev/badge/github.com/intentius/mudflaps.svg)](https://pkg.go.dev/github.com/intentius/mudflaps)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)