diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644
index 0000000..54eb10c
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,31 @@
+# Read the Docs configuration file
+#
+# References:
+#  - https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+#  - https://docs.readthedocs.com/platform/stable/build-customization.html
+#  - https://github.com/astral-sh/uv/issues/10074
+
+version: 2
+
+build:
+    os: ubuntu-24.04
+    tools:
+        python: "3.14"
+    jobs:
+        create_environment:
+            - asdf plugin add uv
+            - asdf install uv latest
+            - asdf global uv latest
+            - UV_PROJECT_ENVIRONMENT=$READTHEDOCS_VIRTUALENV_PATH uv sync --only-group docs --link-mode=copy
+        install:
+            - "true"
+
+formats:
+    - htmlzip
+    - pdf
+    # - epub
+    # - all
+
+sphinx:
+    configuration: docs/conf.py
+    fail_on_warning: false # true is too strict