diff --git a/tutorial/README.md b/tutorial/README.md
new file mode 100644
index 0000000..34a93be
--- /dev/null
+++ b/tutorial/README.md
@@ -0,0 +1,107 @@
+
+# How to assemble the DIY MEGA65 keyboard
+
+_Images are clickable for a larger (full res) version_
+
+## 1. Get the parts
+
+Get the board from a reliable source or order some to your preferred manufacturer from this KiCad project.
+
+* Inspect the board for any defect\
+[![Component side of the board](images/small/mega65-kbd-pcb-back.png)](images/mega65-kbd-pcb-back.png)
+[![Key switchs side of the board](images/small/mega65-kbd-pcb-front.png)](images/mega65-kbd-pcb-front.png)
+
+* Get the components from your preferred supplier\
+[![Check components](images/small/mega65-kbd-components.png)](images/mega65-kbd-components.png)
+[![Have your key switchs](images/small/mega65-kbd-components-keyswitches.png)](images/mega65-kbd-components-keyswitches.png)
+
+## 2. Assembly ( Get you soldering iron ready ! )
+
+### 2.1 The RGB LEDs
+
+1. Place the RGB LED in the correct orientation (see datasheet if not sure) on the board´s pads around the view-through hole.\
+[![Place the RGB LED](images/small/mega65-kbd-rgb-led-placed.png)](images/mega65-kbd-rgb-led-placed.png)
+2. While holding it as steadily as possible with small tweezers, apply a first point of solder.\
+[![Solder a first corner of the LED](images/small/mega65-kbd-rgb-led-first-solder.png)](images/mega65-kbd-rgb-led-first-solder.png)
+[![First corner done](images/small/mega65-kbd-rgb-led-1-pad-soldered.png)](images/mega65-kbd-rgb-led-1-pad-soldered.png)
+3. Then solder the remaining 3 pads.
+4. Proceed likewise with the 3 other RGB LEDs.
+
+### 2.2 The TCA/PCA9555s
+
+1. Place a first TCA/PCA9555 chip on its pads.\
+[![Place the PCA9555](images/small/mega65-kbd-pca9555-placed.png)](images/mega65-kbd-pca9555-placed.png)
+2. While holding it, draw a blob of solder across the pads on one side.\
+[![Apply a big blob of solder](images/small/mega65-kbd-pca9555-first-solder.png)](images/mega65-kbd-pca9555-first-solder.png)
+[![Swipe the solder on all pads](images/small/mega65-kbd-pca9555-solder-spread.png)](images/mega65-kbd-pca9555-solder-spread.png)\
+Do the same for the other side.
+3. Apply a lot of flux on the pads, and draw repeatedly the cleaned iron tip to remove the excess solder from them.\
+[![Cleanup the pads](images/small/mega65-kbd-pca9555-soldered.png)](images/mega65-kbd-pca9555-soldered.png)\
+You can help the removal with a copper braid.\
+Note that for the cleaning part, I had to raise the iron temperature to 400°C.
+And afterwards, my tip was so burnt it needed a lot of regenerative cleaning... 
+4. Repeat the process for all the other chips.
+
+#### Remark
+
+For those who are lucky enough to have a hot air soldering station, you will obviously get easier and cleaner results.\
+[![Soldered with a hot air repair station](images/small/mega65-kbd-pca9555-heatgun-soldered.png)](images/mega65-kbd-pca9555-heatgun-soldered.png)
+
+### 2.3 The resistors
+
+1. Prepare your resistor by bending their leads to around 10mm apart.\
+[![Bend the resistors' legs](images/small/mega65-kbd-130resistors-prepared.png)](images/mega65-kbd-130resistors-prepared.png)
+2. Put them at their spot, bending their legs outwards to prevent them falling when flipping the board for soldering.
+[![Place the resistors](images/small/mega65-kbd-resistors-placed.png)](images/mega65-kbd-resistors-placed.png)
+3. Solder them gently ensuring a good wetting on the lead and make the solder sink in the holes.\
+[![Solder the resistors](images/small/mega65-kbd-resistors-soldered.png)](images/mega65-kbd-resistors-soldered.png)\
+Recommended tip temperature : between 250°C and 300°C
+4. Cut the leads as close to the board as possible. (no picture here, but next ones will show that)
+
+### 2.4 The connectors
+
+1. Place the 2 connectors on the back side of the board.\
+[![Place the connectors](images/small/mega65-kbd-connectors-placed.png)](images/mega65-kbd-connectors-placed.png)
+2. Solder them by starting with one pin while holding it.
+
+### 2.5 The key switches
+
+1. Place the standard key switches of your choice on the front side of the board, leaving out the Caps Lock and Shift Lock free.\
+Place the two "clicky" key switches at the Caps Lock and Shift Lock positions.\
+[![Board with key switches](images/small/mega65-kbd-pcb-with-switches.png)](images/mega65-kbd-pcb-with-switches.png)
+
+2. Return the board by placing a large cardboard on the switches, to prevent them from falling off if they don't have retaining studs.
+[![Key switches on the back](images/small/mega65-kbd-keys-placed-back.png)](images/mega65-kbd-keys-placed-back.png)
+
+3. Solder all the contacts.\
+[![Key switches soldered](images/small/mega65-kbd-keys-soldered.png)](images/mega65-kbd-keys-soldered.png)
+
+And voilà, you have hopefully a brand new working MEGA65 keyboard ready to serve.\
+[![Keyboard complete](images/small/mega65-kbd-board-complete-less-lock-leds.png)](images/mega65-kbd-board-complete-less-lock-leds.png)
+
+### 2.6 Now is a good time to test the keyboard
+
+Now that all major components are in place, you can hook up the keyboard with a 10 conductors flat cable to your NEXYS4 or other supported FPGA development board running the MEGA65 core.\
+[![Connect to the NEXYS4](images/small/mega65-kbd-to-nexys-flat-to-pmodC.png)](images/mega65-kbd-to-nexys-flat-to-pmodC.png)
+
+Start your board and check that the new keyboard has been detected.
+Go to the keyboard test utility (hold Alt at power up and select **3. KEYBOARD TEST**), and try every key.
+
+### 2.7 The "lock" switches LEDs
+
+Insert the two 3mm LEDs in the dedicated holes of the clicky keys.
+With the MEGA65 turned on, test the Caps Lock and Shift Lock keys to check that the LEDs toggle correctly.
+If any LED doesn't illuminate, try reversing it in its slot. Polarity may have been wrong.
+
+Once you're confident the lock LEDs work correctly, turn off the MEGA65, unplug the keyboard and solder them.
+
+### 2.8 The stabilizer bars
+
+Place the Return and Space Bar stabilizer bars on the board, securing them gently with 2 screws on the back.
+
+### 2.9 And finally, fit the keycaps
+
+Now, I guess you didn't wait for this last step.
+But if you did, it's now time to place all the keycaps on the board, and start enjoying your new keyboard !!!
+
+## 3. Have fun !
\ No newline at end of file
diff --git a/tutorial/images/mega65-kbd-130resistors-prepared.png b/tutorial/images/mega65-kbd-130resistors-prepared.png
new file mode 100644
index 0000000..b95fd66
Binary files /dev/null and b/tutorial/images/mega65-kbd-130resistors-prepared.png differ
diff --git a/tutorial/images/mega65-kbd-board-complete-less-lock-leds.png b/tutorial/images/mega65-kbd-board-complete-less-lock-leds.png
new file mode 100644
index 0000000..a2b9ad4
Binary files /dev/null and b/tutorial/images/mega65-kbd-board-complete-less-lock-leds.png differ
diff --git a/tutorial/images/mega65-kbd-components-keyswitches.png b/tutorial/images/mega65-kbd-components-keyswitches.png
new file mode 100644
index 0000000..742b571
Binary files /dev/null and b/tutorial/images/mega65-kbd-components-keyswitches.png differ
diff --git a/tutorial/images/mega65-kbd-components.png b/tutorial/images/mega65-kbd-components.png
new file mode 100644
index 0000000..530f24a
Binary files /dev/null and b/tutorial/images/mega65-kbd-components.png differ
diff --git a/tutorial/images/mega65-kbd-connectors-placed.png b/tutorial/images/mega65-kbd-connectors-placed.png
new file mode 100644
index 0000000..16b32a8
Binary files /dev/null and b/tutorial/images/mega65-kbd-connectors-placed.png differ
diff --git a/tutorial/images/mega65-kbd-keys-placed-back.png b/tutorial/images/mega65-kbd-keys-placed-back.png
new file mode 100644
index 0000000..2ba3085
Binary files /dev/null and b/tutorial/images/mega65-kbd-keys-placed-back.png differ
diff --git a/tutorial/images/mega65-kbd-keys-soldered.png b/tutorial/images/mega65-kbd-keys-soldered.png
new file mode 100644
index 0000000..bb39789
Binary files /dev/null and b/tutorial/images/mega65-kbd-keys-soldered.png differ
diff --git a/tutorial/images/mega65-kbd-pca9555-first-solder.png b/tutorial/images/mega65-kbd-pca9555-first-solder.png
new file mode 100644
index 0000000..99635f0
Binary files /dev/null and b/tutorial/images/mega65-kbd-pca9555-first-solder.png differ
diff --git a/tutorial/images/mega65-kbd-pca9555-heatgun-soldered.png b/tutorial/images/mega65-kbd-pca9555-heatgun-soldered.png
new file mode 100644
index 0000000..2245114
Binary files /dev/null and b/tutorial/images/mega65-kbd-pca9555-heatgun-soldered.png differ
diff --git a/tutorial/images/mega65-kbd-pca9555-placed.png b/tutorial/images/mega65-kbd-pca9555-placed.png
new file mode 100644
index 0000000..d66cdb4
Binary files /dev/null and b/tutorial/images/mega65-kbd-pca9555-placed.png differ
diff --git a/tutorial/images/mega65-kbd-pca9555-solder-spread.png b/tutorial/images/mega65-kbd-pca9555-solder-spread.png
new file mode 100644
index 0000000..ae4eef0
Binary files /dev/null and b/tutorial/images/mega65-kbd-pca9555-solder-spread.png differ
diff --git a/tutorial/images/mega65-kbd-pca9555-soldered.png b/tutorial/images/mega65-kbd-pca9555-soldered.png
new file mode 100644
index 0000000..f2c442d
Binary files /dev/null and b/tutorial/images/mega65-kbd-pca9555-soldered.png differ
diff --git a/tutorial/images/mega65-kbd-pcb-back.png b/tutorial/images/mega65-kbd-pcb-back.png
new file mode 100644
index 0000000..2014767
Binary files /dev/null and b/tutorial/images/mega65-kbd-pcb-back.png differ
diff --git a/tutorial/images/mega65-kbd-pcb-front.png b/tutorial/images/mega65-kbd-pcb-front.png
new file mode 100644
index 0000000..8a51fe8
Binary files /dev/null and b/tutorial/images/mega65-kbd-pcb-front.png differ
diff --git a/tutorial/images/mega65-kbd-pcb-with-switches.png b/tutorial/images/mega65-kbd-pcb-with-switches.png
new file mode 100644
index 0000000..ce84739
Binary files /dev/null and b/tutorial/images/mega65-kbd-pcb-with-switches.png differ
diff --git a/tutorial/images/mega65-kbd-resistors-placed.png b/tutorial/images/mega65-kbd-resistors-placed.png
new file mode 100644
index 0000000..96355f6
Binary files /dev/null and b/tutorial/images/mega65-kbd-resistors-placed.png differ
diff --git a/tutorial/images/mega65-kbd-resistors-soldered.png b/tutorial/images/mega65-kbd-resistors-soldered.png
new file mode 100644
index 0000000..667f18f
Binary files /dev/null and b/tutorial/images/mega65-kbd-resistors-soldered.png differ
diff --git a/tutorial/images/mega65-kbd-rgb-led-1-pad-soldered.png b/tutorial/images/mega65-kbd-rgb-led-1-pad-soldered.png
new file mode 100644
index 0000000..8087295
Binary files /dev/null and b/tutorial/images/mega65-kbd-rgb-led-1-pad-soldered.png differ
diff --git a/tutorial/images/mega65-kbd-rgb-led-first-solder.png b/tutorial/images/mega65-kbd-rgb-led-first-solder.png
new file mode 100644
index 0000000..4b5c476
Binary files /dev/null and b/tutorial/images/mega65-kbd-rgb-led-first-solder.png differ
diff --git a/tutorial/images/mega65-kbd-rgb-led-placed.png b/tutorial/images/mega65-kbd-rgb-led-placed.png
new file mode 100644
index 0000000..24a487b
Binary files /dev/null and b/tutorial/images/mega65-kbd-rgb-led-placed.png differ
diff --git a/tutorial/images/mega65-kbd-to-nexys-flat-to-pmodC.png b/tutorial/images/mega65-kbd-to-nexys-flat-to-pmodC.png
new file mode 100644
index 0000000..b00ff06
Binary files /dev/null and b/tutorial/images/mega65-kbd-to-nexys-flat-to-pmodC.png differ
diff --git a/tutorial/images/small/mega65-kbd-130resistors-prepared.png b/tutorial/images/small/mega65-kbd-130resistors-prepared.png
new file mode 100644
index 0000000..1c095e2
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-130resistors-prepared.png differ
diff --git a/tutorial/images/small/mega65-kbd-board-complete-less-lock-leds.png b/tutorial/images/small/mega65-kbd-board-complete-less-lock-leds.png
new file mode 100644
index 0000000..87b034b
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-board-complete-less-lock-leds.png differ
diff --git a/tutorial/images/small/mega65-kbd-components-keyswitches.png b/tutorial/images/small/mega65-kbd-components-keyswitches.png
new file mode 100644
index 0000000..c9e07c6
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-components-keyswitches.png differ
diff --git a/tutorial/images/small/mega65-kbd-components.png b/tutorial/images/small/mega65-kbd-components.png
new file mode 100644
index 0000000..5c1166d
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-components.png differ
diff --git a/tutorial/images/small/mega65-kbd-connectors-placed.png b/tutorial/images/small/mega65-kbd-connectors-placed.png
new file mode 100644
index 0000000..905c46d
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-connectors-placed.png differ
diff --git a/tutorial/images/small/mega65-kbd-keys-placed-back.png b/tutorial/images/small/mega65-kbd-keys-placed-back.png
new file mode 100644
index 0000000..2a6533f
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-keys-placed-back.png differ
diff --git a/tutorial/images/small/mega65-kbd-keys-soldered.png b/tutorial/images/small/mega65-kbd-keys-soldered.png
new file mode 100644
index 0000000..6343d75
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-keys-soldered.png differ
diff --git a/tutorial/images/small/mega65-kbd-pca9555-first-solder.png b/tutorial/images/small/mega65-kbd-pca9555-first-solder.png
new file mode 100644
index 0000000..074de76
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-pca9555-first-solder.png differ
diff --git a/tutorial/images/small/mega65-kbd-pca9555-heatgun-soldered.png b/tutorial/images/small/mega65-kbd-pca9555-heatgun-soldered.png
new file mode 100644
index 0000000..be4e377
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-pca9555-heatgun-soldered.png differ
diff --git a/tutorial/images/small/mega65-kbd-pca9555-placed.png b/tutorial/images/small/mega65-kbd-pca9555-placed.png
new file mode 100644
index 0000000..dc1c415
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-pca9555-placed.png differ
diff --git a/tutorial/images/small/mega65-kbd-pca9555-solder-spread.png b/tutorial/images/small/mega65-kbd-pca9555-solder-spread.png
new file mode 100644
index 0000000..5b9b5fc
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-pca9555-solder-spread.png differ
diff --git a/tutorial/images/small/mega65-kbd-pca9555-soldered.png b/tutorial/images/small/mega65-kbd-pca9555-soldered.png
new file mode 100644
index 0000000..2534ce9
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-pca9555-soldered.png differ
diff --git a/tutorial/images/small/mega65-kbd-pcb-back.png b/tutorial/images/small/mega65-kbd-pcb-back.png
new file mode 100644
index 0000000..206c296
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-pcb-back.png differ
diff --git a/tutorial/images/small/mega65-kbd-pcb-front.png b/tutorial/images/small/mega65-kbd-pcb-front.png
new file mode 100644
index 0000000..60212e6
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-pcb-front.png differ
diff --git a/tutorial/images/small/mega65-kbd-pcb-with-switches.png b/tutorial/images/small/mega65-kbd-pcb-with-switches.png
new file mode 100644
index 0000000..a86d29e
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-pcb-with-switches.png differ
diff --git a/tutorial/images/small/mega65-kbd-resistors-placed.png b/tutorial/images/small/mega65-kbd-resistors-placed.png
new file mode 100644
index 0000000..34d5c80
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-resistors-placed.png differ
diff --git a/tutorial/images/small/mega65-kbd-resistors-soldered.png b/tutorial/images/small/mega65-kbd-resistors-soldered.png
new file mode 100644
index 0000000..cf51f85
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-resistors-soldered.png differ
diff --git a/tutorial/images/small/mega65-kbd-rgb-led-1-pad-soldered.png b/tutorial/images/small/mega65-kbd-rgb-led-1-pad-soldered.png
new file mode 100644
index 0000000..22edf8a
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-rgb-led-1-pad-soldered.png differ
diff --git a/tutorial/images/small/mega65-kbd-rgb-led-first-solder.png b/tutorial/images/small/mega65-kbd-rgb-led-first-solder.png
new file mode 100644
index 0000000..b9ca29b
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-rgb-led-first-solder.png differ
diff --git a/tutorial/images/small/mega65-kbd-rgb-led-placed.png b/tutorial/images/small/mega65-kbd-rgb-led-placed.png
new file mode 100644
index 0000000..c532c32
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-rgb-led-placed.png differ
diff --git a/tutorial/images/small/mega65-kbd-to-nexys-flat-to-pmodC.png b/tutorial/images/small/mega65-kbd-to-nexys-flat-to-pmodC.png
new file mode 100644
index 0000000..b95e98b
Binary files /dev/null and b/tutorial/images/small/mega65-kbd-to-nexys-flat-to-pmodC.png differ