diff --git a/README.md b/README.md
index b9cf58a..2a69cfa 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,23 @@ KiCAD files for the PCB of mkbd65.
 - [Octopart BOM][bom]
 - [Interactive BOM][ibom]
 
+## Firmware
+
+1. Get the QMK firmware from [here](https://gitlab.com/mkbd65/qmk-firmware)
+2. Checkout the `mkbd65` branch
+3. Flash firmware with (change `ansi` to `iso` for different layout):
+   ```shell
+   make mkbd65:ansi
+   ```
+
+You can find the code for the keyboard [here](https://gitlab.com/mkbd65/qmk-firmware/-/tree/mkbd65/keyboards/mkbd65).
+
+## Case
+
+The case for mkbd65 can be found [here](https://gitlab.com/mkbd65/case). It is available for a limited number of smartphones but can easily be adapted to more.
+
+Follow the instructions to build it for your phone.
+
 ---
 
 ![powered by QMK](badge-dark.svg)