diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0d83156
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# Countdown Plugin
+
+A simple countdown timer plugin for Stream Deck.
+
+## Actions
+
+### Countdown
+A configurable countdown timer that displays remaining time with a visual progress ring, allows start/pause/resume/reset controls, supports dial adjustment of duration, and can execute a custom command when the timer completes.