diff --git a/frontend/README.md b/frontend/README.md
new file mode 100644
index 0000000..146fbaf
--- /dev/null
+++ b/frontend/README.md
@@ -0,0 +1,33 @@
+```mermaid
+classDiagram
+Entity <|-- Raspberry
+Entity <|-- Obstacle
+Entity: -Position position
+Entity: -int width
+Entity: -int height
+Entity: -update()
+Entity: -draw()
+Entity: -detectCollision(Entity other)
+class Raspberry{
+-input()
+-boost()
+}
+
+class Obstacle{
+-Entity pipeTop
+-Entity pipeBottom
+-int distanceBetweenPipes
+-int padding
+-resetPosition()
+}
+
+class Position{
+-int _x
+-int _y
+
++get x()
++set x()
++get y()
++set y()
+}
+```
\ No newline at end of file