diff --git a/README.md b/README.md
index 550e71e..7a899b4 100644
--- a/README.md
+++ b/README.md
@@ -91,4 +91,26 @@ Use a local override file to bind personal configuration files and secrets witho
 ### OCI containers utils
 
 - **buildkit**
+- 
+## Development Environment with Dev Container
+
+This project includes a Dev Container configuration to provide a fully reproducible, isolated, and consistent development environment. It ensures that all contributors work with the same toolchain, without requiring any dependencies to be installed on the host system.
+
+**What the Dev Container Provides:**
+
+- A stable, version‑controlled Node.js environment
+- Full support for Vue 3 + Vite development
+- Preinstalled development tools (npm, eslint, etc.)
+- Automatic VS Code integration with recommended extensions
+- A clean, isolated workspace that does not affect the host
+- Deterministic builds and predictable behavior across machines
+
+
+**How to Use It:**
+
+1. Install the Dev Containers extension in VS Code
+1. Open the project folder
+1. VS Code will prompt you to:
+   - Reopen in Container
+1. The container will build automatically and your development environment will be ready