diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4427941
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# Perfect Ear
+
+Train your ears to recognize piano notes !
+
+## Screenshots
+
+![[screenshots/success.png]]
+
+![[screenshots/failure.png]]
+
+## Build ⚙️
+
+```bash
+xmake # xmake will download all the required dependencies
+```
+
+## Run 🏃
+
+```bash
+xmake run
+```
\ No newline at end of file
diff --git a/screenshots/failure.png b/screenshots/failure.png
new file mode 100644
index 0000000..093f517
Binary files /dev/null and b/screenshots/failure.png differ
diff --git a/screenshots/success.png b/screenshots/success.png
new file mode 100644
index 0000000..a37537a
Binary files /dev/null and b/screenshots/success.png differ