diff --git a/docs/images/k8s-1.31.png b/docs/images/k8s-1.31.png
new file mode 100644
index 00000000..291ff03f
--- /dev/null
+++ b/docs/images/k8s-1.31.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:64e27d29b55d3021334a8f6f1256764b915718e74b7829b63fbbcab7d66e8e8c
+size 18596
diff --git a/docs/v1.31.md b/docs/v1.31.md
new file mode 100644
index 00000000..8808ad90
--- /dev/null
+++ b/docs/v1.31.md
@@ -0,0 +1,17 @@
+# ![k8s-v1.31](images/k8s-1.31.png)  KubeZero 1.31 - Elli
+
+## What's new - Major themes
+- all KubeZero and support AMIs based on Alpine 3.21
+
+## Features and fixes
+
+## Version upgrades
+<WIP>
+- cilium 1.16.3
+- istio 1.22.3
+- ArgoCD 2.13.0 [custom ZDT image](https://git.zero-downtime.net/ZeroDownTime/zdt-argocd)
+- Prometheus 2.55.1 / Grafana 11.3.0
+- Nvidia container toolkit 1.17, drivers  565.57.01, Cuda 12.7
+
+## Resources
+- [Kubernetes v1.31 upstream release blog](https://kubernetes.io/blog/2024/08/13/kubernetes-v1-31-release/)