diff --git a/README.md b/README.md
new file mode 100644
index 0000000..241219a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# JPaint
+
+## Description
+Paint toy project to draw shapes. More practice on design patterns. 
+
+![JPaint](https://imgur.com/kzzao6g)
+
+## How to run the code locally
+
+### Requirements:
+
+- Java RE 8
+
+Clone the repository (duh)
+
+## Features
+· Allows either the AI or the user to play.
+
+· It is possible for the AI to play against itself.
+
+· Auto-saved game on close using serialization.
+
+## Implementation
+