diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7172b28
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# LiteCharmsShop
+
+The primary customer-facing web application for the LiteCharms platform.
+
+## 🏗 Architecture
+* **Type:** Kubernetes Deployment
+* **Scale:** Horizontal scaling enabled via `replicas`.
+* **Ingress:** Managed via `IngressRouter` for external traffic routing.
+
+## 🚀 CI/CD Workflow
+* **Trigger:** Pull Request to `master`.
+* **Build:** Compiles .NET 10.0 source.
+* **Containerize:** Docker image pushed to Nexus as `litecharms-scheduler:1.${DRONE_BUILD_NUMBER}`.
+* **Deploy:** * Updates UAT via `kubectl apply`.
+    * Production deployment is triggered via **Promotion** to the `production` target.
+
+## 🌐 Endpoints
+* **UAT:** `https://uat-shop.khongisa.co.za` (Internal/VPN)
+* **Monitoring:** Aspire Dashboard enabled via `Monitoring__Address`.
\ No newline at end of file