diff --git a/README.md b/README.md
new file mode 100644
index 0000000..024fe97
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# MySuperMarioGame
+This is a full screen 2D game like super mario with some basic creatures and maps.
+
+This game is implemented using the Java programming language, using the java graphics librieries.
+
+The used IDE is netbeans (I uploaded all project artifacts), also the game JAR file is uploaded.
+
+This game is free to use and the code is available to anyone to learn from it without any restrictions.