diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a90ec77
--- /dev/null
+++ b/README.md
@@ -0,0 +1,28 @@
+Vending Machine
+===============
+
+A big vending machine for your front garden
+
+## BOM
+
+* MG90s servos
+* ESP32 development board
+* a shelf
+* coin acceptor (PY616 or DG600F)
+
+## Print settings
+* Resolution: 0.2
+* Material: PLA
+* Supports: no
+
+## Contributing
+
+Feel free to remix this design and/or send pull requests to me.
+
+## License
+
+This project is licensed public domain.
+
+## Acknowledgements
+
+* [Public Domain Involute Parameterized Gears](https://www.thingiverse.com/thing:5505) - library used to design the gears