diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f62ae5e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,74 @@
+![SwiftUI](https://img.shields.io/badge/swift-F05138.svg?style=for-the-badge&logo=swift&logoColor=white)
+![iOS](https://img.shields.io/badge/iOS-000000?style=for-the-badge&logo=ios&logoColor=white)
+![Xcode](https://img.shields.io/badge/xcode-336ADB?style=for-the-badge&logo=xcode&logoColor=white)
+[![CodeStyle](https://img.shields.io/badge/code%20style-%E2%9D%A4-FF4081.svg?style=for-the-badge)](https://github.com/realm/SwiftLint)
+![Swift](https://img.shields.io/badge/swift-5.5-F05138.svg?style=for-the-badge)
+![iOS](https://img.shields.io/badge/iOS-15.2-000000?style=for-the-badge)
+![Xcode](https://img.shields.io/badge/xcode-13.2.1-336ADB?style=for-the-badge)
+[![License Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=for-the-badge)](https://opensource.org/licenses/Apache-2.0)
+
+<p align="center"> 
+   <img height="250" src="https://user-images.githubusercontent.com/30066734/157981506-56f30ee4-5227-4c04-9b2d-a265cce45b23.png"/> 
+</p>
+
+<h1 align="center"> Swift-UI Rorty iOS </h1>
+
+iOS Clean Architecture in Rorty is a sample project that presents modern, approach to [iOS](https://developer.apple.com/) application development 
+using [Swift](https://developer.apple.com/swift/) and latest tech-stack.
+
+The goal of the project is to demonstrate best practices, provide a set of guidelines, and present modern Swift-UI
+application architecture that is modular, scalable, maintainable and testable. This application may look simple, but it
+has all of these small details that will set the rock-solid foundation of the larger app suitable for bigger teams and
+long application lifecycle management.
+
+An iOS app built using Swift that consumes [Rick and Morty API](https://rickandmortyapi.com) to display characters, episodes, location from 
+the [TV Series](https://www.imdb.com/title/tt2861424/). It has been built following Clean Architecture Principle, Repository Pattern, MVVM Architecture 
+in the presentation layer as well as Swift UI components.
+
+#******
+
+
+## 🤝 Contributing
+
+Contributions are what make the open source community such an amazing place to be learn, inspire,
+and create. Any contributions you make are **greatly appreciated**.
+
+1. Open an issue first to discuss what you would like to change.
+2. Fork the Project
+3. Create your feature branch (`git checkout -b feature/amazing-feature`)
+4. Commit your changes (`git commit -m 'Add some amazing feature'`)
+5. Push to the branch (`git push origin feature/amazing-feature`)
+6. Open a pull request
+
+Please make sure to update tests as appropriate.
+
+## ✍️ Authors
+
+<a href="https://www.linkedin.com/in/mesut-g-33b41030" target="_blank">
+  <img src="https://avatars.githubusercontent.com/u/30066734?v=4" width="70" align="left">
+</a>
+
+👤 **developersancho**
+
+[![Linkedin](https://img.shields.io/badge/-linkedin-0077B5?style=for-the-badge&logo=linkedin)](https://www.linkedin.com/in/mesut-g-33b41030/)
+[![Medium](https://img.shields.io/badge/-medium-12100E?style=for-the-badge&logo=medium)](https://developersancho.medium.com/)
+
+Feel free to ping me 😉
+
+## License
+
+```license
+Copyright © 2022 - developersancho
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+```