diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fcc3165
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# Harsh
+
+![harsh icon](./assets/icon_256.png)
+
+---
+
+## Description
+
+An enbeded Harmony server implementation written in rust.
+
+> **Warning**
+> This project is in early design phase, it is non conforming and very few features are implemented.
+
+## Usage
+
+To launch the server, use the `start-server.sh` script
+
+To launch the debug client, use the `start-client.sh` script
diff --git a/assets/icon_256.png b/assets/icon_256.png
new file mode 100644
index 0000000..5a1cd30
Binary files /dev/null and b/assets/icon_256.png differ
diff --git a/assets/icon_512.png b/assets/icon_512.png
new file mode 100644
index 0000000..5b09baa
Binary files /dev/null and b/assets/icon_512.png differ