diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2f03b76
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+# (WIP) EggbotWireless
+My attempt at making the ordinary egg-drawing robot a bit special, by adding a battery and a esp8266 to it.
+
+<img src="docs/assembled1.jpg" width="30%">
+<img src="docs/assembled2.jpg" width="30%">
+<img src="docs/disassembled.jpg" width="30%">
+
+## Known issues
+
+It's not quite "wireless and portable" yet, for the reasons mentioned:
+
+* The servo motor triggers overcurrent protection, so external USB power is needed (possible solutions are either using a low-power servo or fixing the li-ion to 5v booster circuit)
+
+* The GCode is generated by inkscape, so needs a computer
+
+## Getting started
+
+### How to build the firmware
+
+Should just work with platformio, but if you're on windows then you need to copy the repo with symlinks 
+
+Also, when uploading the firmware to ESP8266 don't forget to upload the SPIFFS as well - it contains the simple web interface that allows you to run GCode on the device.
+
+If you want it to connect to your WiFi, then you also should either change the defaults in the ConfigManager.cpp
+Or you can set the configuration via serial:
+```
+lcp wifiMode client
+lcp wifiSSID (your ssid)
+lcp wifiPass (your password)
+lcw
+```
+*(lcp stands for "local config put")*
+
+*(lcw stands for "local config write") which saves it to EEPROM*
+
+### How to create GCode
+
+Now creating gcode for this thing is quite tricky - you can use the gcodetools Inkscape extension.
+
+The process is supposed to be like this:
+
+1. Open Utils/egg.svg with Inkscape
+2. Insert something you want to draw as a child of Layer 1 (the rectangle is the egg boundary)
+3. Make it a path
+4. Use path to gcode (Also set minimal arc radius in the settings to something big as drawing arcs with g02 is not supported)
+
+You can look at spiral.svg for an example
\ No newline at end of file
diff --git a/docs/assembled1.jpg b/docs/assembled1.jpg
new file mode 100644
index 0000000..b052352
Binary files /dev/null and b/docs/assembled1.jpg differ
diff --git a/docs/assembled2.jpg b/docs/assembled2.jpg
new file mode 100644
index 0000000..c5f5735
Binary files /dev/null and b/docs/assembled2.jpg differ
diff --git a/docs/disassembled.jpg b/docs/disassembled.jpg
new file mode 100644
index 0000000..b512992
Binary files /dev/null and b/docs/disassembled.jpg differ