diff --git a/README.md b/README.md
index af1de5f..130427a 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,33 @@
 # Coinly
+
+![Tests](https://github.com/SamoilenkoVadym/Coinly/workflows/iOS%20Tests/badge.svg)
+
 Personal Finance Management App
+
+## Features
+- Transaction management
+- Multiple accounts support
+- Currency conversion
+- Category management
+- Financial analytics
+
+## Requirements
+- iOS 15.0+
+- Xcode 14.0+
+- Swift 5.0+
+
+## Installation
+1. Clone the repository
+2. Open Coinly.xcodeproj in Xcode
+3. Build and run
+
+## Architecture
+- MVVM
+- SwiftUI
+- Core Data
+
+## Testing
+The project includes:
+- Unit Tests
+- UI Tests
+- GitHub Actions CI/CD