diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2539bf3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,37 @@
+# ⏳ Work Week Progress Bar
+
+Because staring at the clock is bad for morale, but staring at a **progress bar** is somehow motivating.
+
+This is a small Flask-powered web app that visualizes:
+- **How far through your current workday you are**
+- **How far through your entire work week you are**
+
+It progresses **only during your scheduled work hours**
+
+---
+
+## 🧠 What It Does
+
+### Daily Progress Bar
+- Advances **every minute**
+- Only runs **Sunday–Wednesday**
+- Only between **7:00 AM – 5:30 PM**
+- Before work? Frozen.
+- After work? Done.
+- Not a workday? Blissfully idle.
+
+### Weekly Progress Bar
+- Your work week is **4 days** (Sun–Wed)
+- Each day = **25%**
+- Finishing Sunday = **25% done**
+- During the day, the bar fills smoothly
+- End of Wednesday = **100% freedom**
+
+---
+
+## 🛠 Tech Stack
+
+- **Flask** – serves the page and minds its business
+- **Vanilla JavaScript** – handles all time logic client-side
+- **HTML + CSS** – gradients, glow, and just enough polish
+- **Zero databases** – this app remembers nothing, like a healthy coping mechanism