diff --git a/README.md b/README.md
index a9562c6..36821cc 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,94 @@
-# AD_MAUI
+# Apple Music Clone
 
-A MAUI Apple Music mini-clone based on [these instructions](https://codefirst.iut.uca.fr/git/mchSamples_.NET/MAUI_TP1_2023)
+## Project Overview
 
-## README stuff
+Apple Music allows users to listen to music, browse playlists, and interact with a 
+sophisticated UI to control their playback.
 
-It goes here...
\ No newline at end of file
+This clone does not.
+
+Apple Music Clone is an application built on the .NET MAUI (Multi-platform App UI) 
+framework. It focuses on the `Library` "master-detail". As of the 20th of May 2023,
+it is a _façade_: only the View part of the project is serviceable.
+
+## The View
+
+* ### Library ("master")
+
+  Users can browse a `Library` of `Album` and select any album to inspect.
+
+* ### Album ("detail")
+
+  Users can browse an `Album` of `Songs`.
+
+* ### Dark/Light theme
+
+  This clone replicates the original dark/light themes by Apple music.
+
+  To test this, you can change your device's (or your emulator's) display
+setting to dark/light theme.
+
+* ### `i18n`: `en`, `fr`
+
+  This clone supports two locales: English (by default), and French.
+
+  To test this, you can change your device's (or your emulator's) primary language
+settings to English/French.
+
+* ### Bottom bar
+
+  In Apple Music, a consistent, stylish, slightly transparent bottom bar allows
+navigation between different views, and paying songs.
+
+  In this clone, the bar is just eye-candy, and not even a little bit transparent. 
+
+* ### Top bar
+
+  In Apple Music, a stylish, slightly transparent top bar contains certain menu
+options, and displays the name of the current
+section once the user has scrolled past the corresponding header.
+
+  In this clone, the top bar is left at the OS default.
+
+## Installation
+
+To run the Apple Music Clone, you must first install .NET MAUI. You can follow
+[the official guide](https://learn.microsoft.com/en-us/dotnet/maui/get-started/installation)
+for the same.
+
+Once MAUI is installed, clone this repository and open the `AD_MAUI.sln` Solution in
+*Visual Studio*.
+
+If you don't have an Android emulator installed for *Visual Studio* already, open the
+*Android Device Manager* to take care of that. For reference, this project was tested on a
+`Pixel 5 - API 33 (Android 13.0 - API 33)`.
+
+When you're ready to run the project, please make sure you launch the `AMC.View` project as a
+`Single startup project`, if *Visual Studio* hasn't configured it that way automatically.
+
+## Some known limitations and shortcomings
+
+Concerning the View part of this project:
+* the bottom bar is inserted once in the `Library` view, and once in the `Album` view
+    * instead, it should be incorporated in a main layout.
+* the bottom bar's "top" part, AKA the player, has some repeated code. 
+    ```csharp
+    <ImageButton Source="{AppThemeBinding Light='icon_play.png', Dark='icon_play_dark.png'}" 
+                 Margin="{StaticResource SpaceS}"
+                 HorizontalOptions="End"
+                 VerticalOptions="Center"
+                 HeightRequest="{StaticResource SpaceML}"
+                 WidthRequest="{StaticResource SpaceML}" />
+
+    <ImageButton Source="{AppThemeBinding Light='icon_next.png', Dark='icon_next_dark.png'}" 
+                 Margin="{StaticResource SpaceS}"
+                 HorizontalOptions="End"
+                 VerticalOptions="Center"
+                 HeightRequest="{StaticResource SpaceML}"
+                 WidthRequest="{StaticResource SpaceML}" />
+    ```
+  * instead, it should have been extracted into another reusable component, but there were
+  difficulties in doing that -- having to do with the dark/light themes.
+* the bottom bar is not as stylish as the original. 
+* the top bar was left to the OS default.
+* and many others will join this list, no doubt.
\ No newline at end of file