diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a5ceb61
--- /dev/null
+++ b/README.md
@@ -0,0 +1,52 @@
+# Movies
+
+**Movies** is a Xamarin.Forms **GTK backend** application that makes use of The Movie Database (TMDb) API, a popular, user editable database for movies and TV shows, to demonstrate the possibilities of the new backend making use of a great variety of functionality.
+
+
+
+## Xamarin.Forms App
+
+[Xamarin.Forms](https://www.xamarin.com/forms) allows you to build native UIs for iOS, Android, Windows, macOS and **Linux** from a single, shared codebase. You can dive into mobile development with Xamarin.Forms by following our [free self-guided learning](https://university.xamarin.com/classes/track/self-guided) from Xamarin University. This project exercises the following patterns and features:
+
+* Xamarin.Forms
+ * [XAML UI](https://developer.xamarin.com/guides/xamarin-forms/xaml/xaml-basics/)
+ * Behaviors
+ * Converters
+ * Custom Controls
+ * [Custom Renderers](https://developer.xamarin.com/guides/xamarin-forms/custom-renderer/)
+ * [Data Binding](https://developer.xamarin.com/guides/xamarin-forms/xaml/xaml-basics/data_binding_basics/)
+ * IoC
+ * [Messaging Center](https://developer.xamarin.com/guides/xamarin-forms/messaging-center/)
+ * [MVVM](https://developer.xamarin.com/guides/xamarin-forms/xaml/xaml-basics/data_bindings_to_mvvm/)
+ * [Styles](https://developer.xamarin.com/guides/xamarin-forms/user-interface/styles/)
+ * Triggers
+ * Gtk Themes
+
+## Screens
+
+
+
+## Requirements
+* Windows 10
+* [Visual Studio __2015__](https://www.visualstudio.com/en-us/products/vs-2015-product-editions.aspx) Update 3 (14.0 or higher) to compile C# 6 language features (or Visual Studio MacOS)
+* Xamarin add-ons for Visual Studio 3.2.1.64 or higher (available via the Visual Studio installer)
+* __Visual Studio Community Edition is fully supported!__
+
+## Setup
+
+**Download** or clone the repository. This is a solution with two projects.
+
+**Rebuild** the solution to get all neccesary **NuGet** packages.
+
+Access to **AppSettings.cs** file available in the Portable Class Library to introduce your TMDb APIs key.
+
+
+Enjoy!
+
+## Clean and Rebuild
+
+If you see build issues when pulling updates from the repo, try cleaning and rebuilding the solution.
+
+## Copyright and license
+
+Code released under the [MIT license](https://opensource.org/licenses/MIT).
diff --git a/images/casting01.png b/images/casting01.png
new file mode 100644
index 0000000..f75a2a3
Binary files /dev/null and b/images/casting01.png differ
diff --git a/images/casting02.png b/images/casting02.png
new file mode 100644
index 0000000..84ad2b2
Binary files /dev/null and b/images/casting02.png differ
diff --git a/images/discover.png b/images/discover.png
new file mode 100644
index 0000000..e5c257b
Binary files /dev/null and b/images/discover.png differ
diff --git a/images/gallery.png b/images/gallery.png
new file mode 100644
index 0000000..aa97050
Binary files /dev/null and b/images/gallery.png differ
diff --git a/images/homepage.png b/images/homepage.png
new file mode 100644
index 0000000..20775b7
Binary files /dev/null and b/images/homepage.png differ
diff --git a/images/menu.png b/images/menu.png
new file mode 100644
index 0000000..72dc332
Binary files /dev/null and b/images/menu.png differ
diff --git a/images/movie-detail.png b/images/movie-detail.png
new file mode 100644
index 0000000..1b734d6
Binary files /dev/null and b/images/movie-detail.png differ
diff --git a/images/movies-list.png b/images/movies-list.png
new file mode 100644
index 0000000..bf134f2
Binary files /dev/null and b/images/movies-list.png differ
diff --git a/images/movies.png b/images/movies.png
new file mode 100644
index 0000000..62ff599
Binary files /dev/null and b/images/movies.png differ
diff --git a/images/shows.png b/images/shows.png
new file mode 100644
index 0000000..507e3f3
Binary files /dev/null and b/images/shows.png differ
diff --git a/images/upcoming.png b/images/upcoming.png
new file mode 100644
index 0000000..15c2b9f
Binary files /dev/null and b/images/upcoming.png differ