diff --git a/.devcontainer/README.md b/.devcontainer/README.md
new file mode 100644
index 000000000..32df23295
--- /dev/null
+++ b/.devcontainer/README.md
@@ -0,0 +1,15 @@
+# Dev Container
+
+This folder contains configuration for developing quickfix inside a containerized environment. It includes:
+
+- `Dockerfile.dev` – defines the base image and toolchain for the Go FIX engine.
+- `devcontainer.json` – settings used by editors like Visual Studio Code to launch the dev container.
+- `docker-compose.yml` – sample compose file for bringing up a dependent database stack.
+
+To use the development container with VS Code:
+
+1. Install the "Remote – Containers" extension.
+2. Open the repository in VS Code.
+3. Use the command palette and select **Remote-Containers: Open Folder in Container...**.
+
+The dev container will automatically build the image and set up everything you need to hack on the project.