diff --git a/.markdownlint.yaml b/.markdownlint.yaml
index 77dfb50..c26d891 100644
--- a/.markdownlint.yaml
+++ b/.markdownlint.yaml
@@ -3,4 +3,6 @@
"MD013": false,
"MD024": false,
"MD029": { "style": one },
+ "MD033": false,
+ "MD041": false,
}
diff --git a/README.md b/README.md
index 44c2149..e7622ef 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,6 @@
-#  Reloader
+
+
+
[](https://goreportcard.com/report/github.com/stakater/reloader)
[](https://godoc.org/github.com/stakater/reloader)
@@ -9,13 +11,42 @@
[](LICENSE)
[](https://stakater.com/?utm_source=Reloader&utm_medium=github)
-## Problem
+## 🔁 What is Reloader?
-We would like to watch if some change happens in `ConfigMap` and/or `Secret`; then perform a rolling upgrade on relevant `DeploymentConfig`, `Deployment`, `Daemonset`, `Statefulset` and `Rollout`
+Reloader is a Kubernetes controller that automatically triggers rollouts of workloads (like Deployments, StatefulSets, and more) whenever referenced `Secrets` or `ConfigMaps` are updated.
-## Solution
+In a traditional Kubernetes setup, updating a `Secret` or `ConfigMap` does not automatically restart or redeploy your workloads. This can lead to stale configurations running in production, especially when dealing with dynamic values like credentials, feature flags, or environment configs.
-Reloader can watch changes in `ConfigMap` and `Secret` and do rolling upgrades on Pods with their associated `DeploymentConfigs`, `Deployments`, `Daemonsets` `Statefulsets` and `Rollouts`.
+Reloader bridges that gap by ensuring your workloads stay in sync with configuration changes — automatically and safely.
+
+## 🚀 Why Reloader?
+
+- ✅ **Zero manual restarts**: No need to manually rollout workloads after config/secret changes.
+- 🔒 **Secure by design**: Ensure your apps always use the most up-to-date credentials or tokens.
+- 🛠️ **Flexible**: Works with all major workload types — Deployment, StatefulSet, Daemonset, ArgoRollout, and more.
+- ⚡ **Fast feedback loop**: Ideal for CI/CD pipelines where secrets/configs change frequently.
+- 🔄 **Out-of-the-box integration**: Just label your workloads and let Reloader do the rest.
+
+## 🔧 How It Works
+
+```mermaid
+flowchart LR
+ ExternalSecret -->|Creates| Secret
+ SealedSecret -->|Creates| Secret
+ Secret -->|Watched by| Reloader
+ Configmap -->|Watched by| Reloader
+
+ Reloader -->|Triggers Rollout| Deployment
+ Reloader -->|Triggers Rollout| DeploymentConfig
+ Reloader -->|Triggers Rollout| Daemonset
+ Reloader -->|Triggers Rollout| Statefulset
+ Reloader -->|Triggers Rollout| ArgoRollout
+ Reloader -->|Triggers Job| CronJob
+```
+
+- Sources like `ExternalSecret` or `SealedSecret` create or manage your Kubernetes Secrets.
+- `Secrets` and `ConfigMaps` are watched by Reloader.
+- When changes are detected, Reloader automatically triggers a rollout of the associated workloads, ensuring your app always runs with the latest configuration.
## Enterprise Version
diff --git a/assets/web/reloader-round-100px.png b/assets/web/reloader-round-100px.png
deleted file mode 100644
index 9e84c1d..0000000
Binary files a/assets/web/reloader-round-100px.png and /dev/null differ
diff --git a/assets/web/reloader.jpg b/assets/web/reloader.jpg
new file mode 100644
index 0000000..d510a68
Binary files /dev/null and b/assets/web/reloader.jpg differ