diff --git a/AppDelegate.png b/AppDelegate.png
new file mode 100644
index 0000000..0f63ac5
Binary files /dev/null and b/AppDelegate.png differ
diff --git a/Breakpoint.png b/Breakpoint.png
new file mode 100644
index 0000000..62678aa
Binary files /dev/null and b/Breakpoint.png differ
diff --git a/Code.png b/Code.png
new file mode 100644
index 0000000..e5c35bb
Binary files /dev/null and b/Code.png differ
diff --git a/README.md b/README.md
index c8b3cff..b46896f 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,94 @@
 # PushNotificationSimulation
 
-TODO
+`PushNotificationSimulation` helps in simulating push notifications in the application during development.
+
+[![Swift 5.0](https://img.shields.io/badge/Swift-5.0-green.svg?style=flat)](https://swift.org/)
+[![CocoaPods Compatible](https://img.shields.io/cocoapods/v/PushNotificationSimulation.svg)](https://cocoapods.org/pods/PushNotificationSimulation)
+[![Carthage Compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)
+[![Platform](https://img.shields.io/cocoapods/p/PuzzleMaker.svg)](http://cocoadocs.org/docsets/PuzzleMaker)
+[![License](https://img.shields.io/cocoapods/l/PuzzleMaker.svg)](https://github.com/PGSSoft/PuzzleMaker)
+
+## Installation
+
+Using [Cocoapods](https://cocoapods.org/) with Podfile:
+
+```ruby
+pod 'PushNotificationSimulation'
+```
+
+or using [Carthage](https://github.com/Carthage/Carthage) and add a line to `Cartfile`:
+
+```
+github "pwlkania/PushNotificationSimulation"
+```
+
+or Swift Package Manager (Xcode 11):
+
+Coming soon!
+
+## Requirements
+
+iOS 11.0
+
+## Initialization
+
+First of all, you need to modify your `AppDelegate.swift` file:
+
+Import `PushNotificationSimulation` framework (if needed):
+
+```swift
+import PushNotificationSimulation
+```
+
+Implement `PushNotificationSimulation` protocol:
+
+```swift
+#if DEBUG
+extension AppDelegate: PushNotificationSimulation { }
+#endif
+```
+
+Implement required property from `PushNotificationSimulation` protocol:
+
+```swift
+#if DEBUG
+weak var app: UIApplication?
+#endif
+```
+
+Assign `UIApplication` object to `app` property:
+
+```swift
+func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
+    // Your code...
+        
+    #if DEBUG
+    app = application
+    #endif
+        
+    // Your code...
+    return true
+}
+```
+
+Your `AppDelegate.swfit` file should look similar to this:
+
+![AppDelegate.png](AppDelegate.png)
+
+## Usage
+
+Using breakpoints with debugger command (suggested approach) - example:
+
+```
+e simPush(payload: "{\"aps\":{\"alert\":{\"title\":\"Game Request\",\"subtitle\":\"Five Card Draw\",\"body\":\"Bob wants to play poker\"},\"category\":\"GAME_INVITATION\"},\"gameID\":\"12345678\"}", delay: 3)
+```
+
+![Breakpoint.png](Breakpoint.png)
+
+You can also use `simPush(...)` global function directly in the code. However it might cause issues when code is not deactivated in production version of your application. Be careful.
+
+![Code.png](Code.png)
+
+## License
+
+The project is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).