diff --git a/README.md b/README.md
new file mode 100644
index 0000000..baa575d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,78 @@
+Title: MovieExplorer: An Open Source MVI Architecture Android App
+
+Description:
+MovieExplorer is an open-source Android application built on the Model-View-Intent (MVI) architecture, designed to provide users with a seamless experience in exploring movies. It leverages the latest version of Android Studio and integrates the most recent libraries available through the version catalog, ensuring optimal performance and compatibility.
+
+Features:
+
+**Onboarding Customization**: Tailored onboarding experience to guide users through the app seamlessly.
+
+![alt text](https://github.com/MehdiSekoba/imdb/blob/main/art/Screenshot_2024-04-06-19-19-03-664_com.mehdisekoba.imdb.jpg)
+![alt text](https://github.com/MehdiSekoba/imdb/blob/main/art/Screenshot_2024-04-06-19-19-12-963_com.mehdisekoba.imdb.jpg)
+
+**Lottie Integration**: Utilizes the Lottie library for rich and interactive animations, enhancing user engagement.
+
+**Professional Slider with Carousel**: Employs a professional slider with carousel functionality for smooth navigation through movie content.
+
+![alt text](https://github.com/MehdiSekoba/imdb/blob/main/art/Screenshot_2024-04-06-19-19-27-079_com.mehdisekoba.imdb.jpg)
+
+**Custom Animation Placeholder**: Integrates Coil library to create custom animation placeholders, optimizing image loading experience.
+
+![alt text](https://github.com/MehdiSekoba/imdb/blob/main/art/Screenshot_2024-04-06-19-19-27-079_com.mehdisekoba.imdb.jpg)
+
+**Bottom Navigation and Material 3**: Implements the latest version of BottomNavigation along with Material 3 design guidelines for intuitive navigation.
+
+![alt text](https://github.com/MehdiSekoba/imdb/blob/main/art/Screenshot_2024-04-06-19-19-27-079_com.mehdisekoba.imdb.jpg)
+
+**ShapeAppearanceModel Advanced Usage**: Utilizes advanced ShapeAppearanceModel for enhanced UI design and aesthetics.
+
+![alt text](https://github.com/MehdiSekoba/imdb/blob/main/art/Screenshot_2024-04-06-19-22-43-393_com.mehdisekoba.imdb.jpg)
+
+**Internal Player for Movie Trailers**: Features an internal player for seamless playback of movie trailers within the app.
+
+![alt text](https://github.com/MehdiSekoba/imdb/blob/main/art/Screenshot_2024-04-06-19-22-29-599_com.mehdisekoba.imdb.jpg)
+![alt text](https://github.com/MehdiSekoba/imdb/blob/main/art/Screenshot_2024-04-06-19-23-23-090_com.mehdisekoba.imdb.jpg)
+
+**Advanced Search View**: Incorporates an advanced search view for efficient and convenient exploration of movie content.
+
+![alt text](https://github.com/MehdiSekoba/imdb/blob/main/art/Screenshot_2024-04-06-19-23-44-303_com.mehdisekoba.imdb.jpg)
+
+**Sleek User Interface**: Offers a simple yet elegant user interface for a delightful browsing experience.
+
+![alt text](https://github.com/MehdiSekoba/imdb/blob/main/art/Screenshot_2024-04-06-19-19-27-079_com.mehdisekoba.imdb.jpg)
+
+**Movie Categories Display**: Displays movies categorically for easy browsing and discovery.
+
+![alt text](https://github.com/MehdiSekoba/imdb/blob/main/art/Screenshot_2024-04-06-19-19-57-417_com.mehdisekoba.imdb.jpg)
+
+**Movie Rating Display**: Provides ratings for each movie to aid users in decision-making.
+
+![alt text](https://github.com/MehdiSekoba/imdb/blob/main/art/Screenshot_2024-04-06-19-21-49-422_com.mehdisekoba.imdb.jpg)
+
+**Professional Extensions**: Implements professional extensions for enhanced functionality and usability.
+**Real-Time Internet Connection Checking**: Monitors internet connection in real-time to ensure uninterrupted access to movie data.
+**Custom Material Dialogues**: Utilizes custom Material dialogues for interactive user interactions.
+**Shimmer Effect for Loading**: Enhances the loading experience with the shimmer effect, providing visual feedback during data retrieval.
+![alt text](https://github.com/MehdiSekoba/imdb/blob/main/art/Screenshot_2024-04-06-19-23-16-505_com.mehdisekoba.imdb.jpg)
+
+Support:
+If you find this project useful, your support through giving it a star or forking it on GitHub would be greatly appreciated.
+This comprehensive Android application is designed to cater to movie enthusiasts and developers alike, offering a rich set of features and an intuitive user experience. Feel free to contribute, customize, or extend the functionality of the app as per your requirements and preferences.
+# License
+```xml
+Copyright 2024 Mehdi Sekoba
+
+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.
+```
+
+