Enhance README with detailed features, architecture overview, and setup instructions

Author: abd3lraouf

README.md

@@ -1,2 +1,72 @@
-# decompose-tutorial
-A comprehensive tutorial project showcasing Decompose for reactive UI component architecture in Kotlin Android development
+# Decompose Tutorial
+
+![Kotlin](https://img.shields.io/badge/kotlin-1.9.0-blue.svg?logo=kotlin)
+![Compose](https://img.shields.io/badge/Jetpack_Compose-Latest-green.svg?logo=jetpackcompose)
+![Decompose](https://img.shields.io/badge/Decompose-2.1.0-purple.svg)
+
+A comprehensive tutorial project showcasing Decompose for reactive UI component architecture in Kotlin Android development.
+
+## 🚀 Overview
+
+Decompose is a powerful Kotlin library for building component-based UIs with clean separation of concerns. This tutorial demonstrates how to create modular, maintainable Android applications using Decompose with Jetpack Compose.
+
+## ✨ Key Features
+
+- **Component-Based Architecture**: Modular UI components with encapsulated logic
+- **State Management**: Reactive state with unidirectional data flow
+- **Type-Safe Navigation**: Navigation between components without Fragments
+- **Back Stack Management**: Support for navigation history
+- **Lifecycle Management**: Clean component lifecycle handling
+
+## 🏗️ Architecture
+
+This project follows a component-based architecture where each screen is a self-contained component:
+
+```
+App
+ ├── Root Component
+ │    ├── Todo List Component
+ │    │    └── Todo Item Component
+ │    └── Todo Detail Component
+ └── DI / Infrastructure
+```
+
+## 📋 Todo App Implementation
+
+This tutorial implements a Todo application with a three-stage workflow:
+
+1. **Todo Stage**:
+   - Display: Play button (no checkbox)
+   - Action: Clicking play button moves todo to "In Progress" stage
+
+2. **In Progress Stage**:
+   - Display: Checkbox
+   - Action: Checking the box moves todo to "Done" stage
+
+3. **Done Stage**:
+   - Display: Checkbox (checked)
+   - Action: Unchecking the box moves todo back to "Todo" stage
+
+## 🛠️ Setup Instructions
+
+1. Clone the repository
+2. Open the project in Android Studio
+3. Build and run the app
+
+## 📚 Technologies
+
+- **Kotlin**: Modern programming language
+- **Jetpack Compose**: UI toolkit
+- **Decompose**: Component architecture
+- **Kotlin Coroutines**: Asynchronous programming
+
+## 👨‍💻 About the Author
+
+**Abdelraouf Sabri** - Senior Android Developer
+
+- Website: [abd3lraouf.dev](https://abd3lraouf.dev)
+- GitHub: [@abd3lraouf](https://github.com/abd3lraouf)
+
+---
+
+⭐️ Star this repository if you find it helpful!