diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644
index 0000000..9e897af
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,20 @@
+# SPDX-FileCopyrightText: 2025 PythonWoods <dev@pythonwoods.dev>
+# SPDX-License-Identifier: Apache-2.0
+
+# Read the Docs configuration for Docusaurus v3
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    nodejs: "22"
+
+  commands:
+    # 1. Installazione deterministica delle dipendenze (root-based)
+    - npm ci
+    # 2. Generazione del sito statico
+    - npm run build
+    # 3. Preparazione directory di output RTD
+    - mkdir --parents $READTHEDOCS_OUTPUT/html/
+    # 4. Trasferimento della build (la cartella è 'build/', non 'docs/build/')
+    - cp --recursive build/* $READTHEDOCS_OUTPUT/html/