diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index b0ab1a1..e5411d7 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -10,13 +10,16 @@ build:
   tools:
     python: "3.13"
 
+  # custom build process
+  # https://docs.readthedocs.io/en/stable/build-customization.html#install-dependencies-with-uv
   commands:
+    # dependencies
+    - asdf plugin add uv
+    - asdf install uv latest
+    - asdf global uv latest
+    - uv sync --extra docs --frozen
+    - uv pip sync docs/requirements.txt
+    # build
     - myst build --html
+    # deploy
     - mv _build/html $READTHEDOCS_OUTPUT/html
-
-# Optionally, but recommended,
-# declare the Python requirements required to build your documentation
-# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
-python:
-   install:
-   - requirements: requirements.txt