diff --git a/README.md b/README.md
new file mode 100644
index 0000000..042b5f0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# Mlaumcherb - a minecraft laumcherb
+
+<img src="./images/cheems.png" alt="silly-dog-picture" style="width:200px;"/>
+
+## Features
+- Downloads minecraft from mojang server or any other
+- Downloads java or uses whatever you specified in config
+- Downloads modpacks of my custom format
+- Automatic launcher updates from git releases
+
+## How to build
+```sh
+./build.sh selfcontained
+```
diff --git a/Mlaumcherb.Client.Avalonia/build.sh b/build.sh
similarity index 100%
rename from Mlaumcherb.Client.Avalonia/build.sh
rename to build.sh
diff --git a/images/cheems.png b/images/cheems.png
new file mode 100644
index 0000000..3677e34
Binary files /dev/null and b/images/cheems.png differ
diff --git a/mlaumcherb.sln b/mlaumcherb.sln
index dfaad27..3ff051f 100644
--- a/mlaumcherb.sln
+++ b/mlaumcherb.sln
@@ -5,6 +5,8 @@ EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "SolutionFolder", "SolutionFolder", "{A3217C18-CC0D-4CE8-9C48-1BDEC1E1B333}"
 	ProjectSection(SolutionItems) = preProject
 		.gitignore = .gitignore
+		README.md = README.md
+		build.sh = build.sh
 	EndProjectSection
 EndProject
 Global