diff --git a/.epinio-sync.yaml b/.epinio-sync.yaml
new file mode 100644
index 0000000..ac76df3
--- /dev/null
+++ b/.epinio-sync.yaml
@@ -0,0 +1,21 @@
+# .epinio-sync.yaml
+# app watch reads this file to decide how to sync local changes into the running pod.
+#
+# Run (app must already be pushed):
+#   epinio app watch wordpress --path .
+#
+# PHP/WordPress is interpreted, so this app uses files mode.
+# Do not set build_cmd or binary — those fields switch watch to binary mode
+# (used for compiled languages like Go or Java).
+#
+# On every save, watch uploads only the changed files into the pod and the
+# supervisor restarts the PHP/nginx process so the new source is picked up.
+#
+# Push this app from the repo root (not wordpress/). Paketo needs
+# BP_PHP_WEB_DIR=wordpress plus a MySQL service; those are push-time settings,
+# not watch settings. See this repo's README.
+
+# Directory inside the pod where source files are written.
+# This matches the default Paketo / Cloud Native Buildpacks layout.
+# The WordPress tree stays at wordpress/ under this directory.
+files_dest: "/workspace/source/app"