diff --git a/README.md b/README.md
index 9c03841..9026b24 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,27 @@
-# esphomefiles
+# esphomeconfig
 
 This contains clerie's esphome configs.
+
+## Build and flash
+
+Make sure esphome cli is available:
+
+```
+nix shell nixpkgs#esphome
+```
+
+Build firmware for device:
+
+```
+esphome compile nodes/d1-mini-scd40-fee158/firmware.yaml
+```
+
+Connect device via USB.
+
+Flash firmware to device:
+
+```
+esphome upload nodes/d1-mini-scd40-fee158/firmware.yaml
+```
+
+The command asks interactively for the serial interface to flash the firmware to.