diff --git a/README.md b/README.md
index 3eeb66b..6de114b 100644
--- a/README.md
+++ b/README.md
@@ -4,4 +4,42 @@ I tried different Home Assistant add-ons and integrations, but wasn't really sat
 
 This blueprint for HA was initially inspired by [ha-smarter-thermostat by muratcesmecioglu](https://github.com/muratcesmecioglu/ha-smarter-thermostat), but deviated through extending to also include an away calendar and a manual overwrite mode to allow manual inputs on the thermostats.
 
-Testing is ongoing.
\ No newline at end of file
+# 🌡️ Smart Thermostat Controller Blueprint
+An intelligent Home Assistant automation that manages your heating based on multiple conditions for optimal comfort and energy efficiency.
+
+## ✨ Features
+🪟 Window/Door Detection
+Automatically turns off heating when windows or doors are opened, preventing energy waste. Configurable delay to avoid false triggers.
+
+## 🌤️ Weather-Based Control
+Monitors outdoor temperature and disables heating when it's warm enough outside. Includes adjustable winter mode threshold and delay settings.
+📅 Schedule-Based Temperature Control
+Uses a schedule helper or calendar to set different temperatures for:
+
+☀️ Day Mode - Higher comfort temperature during active hours
+🌙 Night Mode - Lower temperature for sleeping or away periods
+
+## 🏖️ Holiday/Away Mode
+Integrates with a calendar to automatically reduce heating when you're away. Smart pre-heating starts before you return home (configurable offset).
+
+## 🔄 Multi-Thermostat Sync
+Manual adjustment of any thermostat instantly syncs all others to the same temperature, giving you quick override control.
+
+## 🎯 Priority-Based Logic
+
+Manual adjustments (highest priority)
+Windows/doors open → heating OFF
+Too warm outside → heating OFF
+Away mode → reduced temperature
+Day/night schedule → comfort temperatures
+
+## 🛠️ Requirements
+
+Window/door sensor(s) (binary_sensor)
+Outdoor temperature sensor
+Climate entity (thermostat)
+Schedule helper OR calendar for day/night timing
+Calendar for away/holiday periods
+
+## 📊 Smart Logging
+All mode changes are logged to your Home Assistant logbook for easy monitoring and debugging.
\ No newline at end of file