diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3ece30e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# Kubectl Web GUI
+
+A local web-based GUI for kubectl.
+
+## Overview
+This app provides a lightweight local interface to manage Kubernetes clusters via kubectl.
+
+## Features
+- Choose Kubernetes context and namespace
+- Search resources: pods, nodes, PVCs, and others
+- Perform actions: describe, delete, view logs, and more
+
+## Tech Stack
+- Backend: Python
+- Frontend: Lightweight JavaScript
+
+## Plan
+- Build Python backend to execute kubectl commands and serve API
+- Create lightweight JavaScript frontend
+- Implement context/namespace selection
+- Add search and list views for pods, nodes, PVCs, etc.
+- Add action interfaces (describe, delete, logs, etc.)