diff --git a/README.md b/README.md
index 61d3c7e..a665ca2 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,8 @@ macOS is the primary environment; Arch is supported from the start. Configs are
 in `stow/common/` and only ever symlinked into `$HOME` by a **deliberate, manual** Stow step —
 never automatically.
 
+📖 **Documentation site:** <https://fnayou.github.io/dotfiles/>
+
 ## Status
 
 ```
@@ -38,6 +40,9 @@ reserved for platform-specific packages and are currently empty.
 
 ## Documentation
 
+The public documentation site — overview, installation, features, usage, and reference — lives at
+<https://fnayou.github.io/dotfiles/> (built with MkDocs Material from `website/`).
+
 Setup guides are written for a human operator, not for agents.
 
 - [Packages setup](docs/guides/packages-setup.md) — install the tools every package depends on (`git`, `stow`, `go-task`, …).