diff --git a/README.md b/README.md
index fdd3e89..19179a7 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,4 @@
-# shapes
\ No newline at end of file
+# Shapes
+
+Using the JFrame and JPanel subclass to create and compile a program that will display on the screen a single circle or some color.
+Then adding a rectangle using the SmartRectangle class, a diamond with rotation of 45 degrees, a triangle and a star.