From 8df911a10b1671b9f63baaa63b4fb4f536a22d5d Mon Sep 17 00:00:00 2001
From: varun <2300090189csith@gmail.com>
Date: Mon, 14 Apr 2025 15:01:50 +0530
Subject: [PATCH] Update README.md

---
 README.md | 78 +++++++++++++++++++++++++++++++++++++++++++------------
 1 file changed, 61 insertions(+), 17 deletions(-)

diff --git a/README.md b/README.md
index 7e7bca7..16a1e38 100644
--- a/README.md
+++ b/README.md
@@ -1,23 +1,67 @@
+  
 [![Build](https://github.com/SmartHomeOS/HomeKitDotNet/actions/workflows/dotnet.yml/badge.svg)](https://github.com/SmartHomeOS/HomeKitDotNet/actions/workflows/dotnet.yml)
-[![Version](https://img.shields.io/nuget/v/HomeKitDotNet.svg)](https://www.nuget.org/packages/HomeKitDotNet)
-# <img src="HomeKitDotNet/logo.png" height="50"> HomeKitDotNet 
-* A 100% native implementation of a HomeKit Controller in dotnet
-* Works on all architectures and operating systems without dependencies
-* Implements all 243 characteristics and 71 services
+[![NuGet Version](https://img.shields.io/nuget/v/HomeKitDotNet.svg)](https://www.nuget.org/packages/HomeKitDotNet)
 
-#### Working:
-* Pairing
-* Connection Management
-* Reading and writing characteristics
-* Eventing
+# <img src="HomeKitDotNet/logo.png" height="50"> HomeKitDotNet
 
-#### TODO:
-* More Examples
+**HomeKitDotNet** is a 100% native implementation of a **HomeKit Controller** in .NET.
 
-#### Other Projects:
-* Check out my other projects for [ZWave](https://github.com/SmartHomeOS/ZWaveDotNet) and [Matter](https://github.com/SmartHomeOS/MatterDotNet).
+- ✅ Cross-platform support — works on **Windows, Linux, macOS, ARM (e.g. Raspberry Pi)** with no external dependencies  
+- ✅ Fully implements all **243 HomeKit characteristics** and **71 services**  
+- ✅ Designed for **automations, testing, or interfacing with HomeKit accessories** from your own applications
 
-Support is always appreciated:<br/><a href="https://www.buymeacoffee.com/jdomnitz" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-red.png" alt="Buy Me A Pizza" style="height: 60px !important;width: 217px !important;" ></a>
+---
 
-Note:
-This library is not affiliated with or endorsed by Apple
\ No newline at end of file
+## ✨ Features
+
+- 🔐 **Pairing** with HomeKit accessories  
+- 🔄 **Connection management** and secure communication  
+- 📖 **Read and write** characteristics  
+- 🔔 **Eventing** — receive real-time updates from accessories
+
+---
+
+## 📦 Installation
+
+Install via NuGet:
+
+```bash
+dotnet add package HomeKitDotNet
+```
+
+---
+
+## 🚀 Usage
+
+Examples coming soon!  
+In the meantime, check out the `Examples/` folder (or contribute your own via PRs 👇).
+
+---
+
+## 🛠️ TODO
+
+- [ ] Add more usage examples  
+- [ ] Add advanced eventing/automation samples
+
+---
+
+## 🌍 Related Projects
+
+Explore my other smart home projects:
+
+- 🔗 [ZWaveDotNet](https://github.com/SmartHomeOS/ZWaveDotNet) — Native Z-Wave implementation in .NET  
+- 🌐 [MatterDotNet](https://github.com/SmartHomeOS/MatterDotNet) — Matter protocol implementation in .NET  
+
+---
+
+## ☕ Support
+
+If you find this library useful, consider buying me a coffee (or pizza!):
+
+[![Buy Me a Pizza](https://cdn.buymeacoffee.com/buttons/v2/default-red.png)](https://www.buymeacoffee.com/jdomnitz)
+
+---
+
+> **Note:** This project is not affiliated with or endorsed by Apple Inc.  
+> **HomeKit** is a trademark of Apple Inc., registered in the U.S. and other countries.
+```