diff --git a/.readthedocs.yml b/.readthedocs.yml
new file mode 100644
index 0000000..f930765
--- /dev/null
+++ b/.readthedocs.yml
@@ -0,0 +1,20 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+conda:
+   environment: docs/environment.yaml
+
+sphinx:
+   configuration: docs/conf.py
+
+submodules:
+   include: all 
+
+build:
+   os: "ubuntu-lts-latest" # https://docs.readthedocs.io/en/stable/config-file/v2.html#build-os
+   tools:
+      python: "mambaforge-latest" # https://docs.readthedocs.io/en/stable/config-file/v2.html#build-tools-python, mamba instead of conda for better build performance