diff --git a/README.md b/README.md
index 9ff0e81..b2736b1 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,18 @@
 # tartan-maker
+
+## description
+
 A tartan is a
 > patterned cloth with crossing horizontal and vertical bands in multiple colours, forming simple or complex rectangular patterns (Wikipedia).
 
 This script allows you to generate pictures of such patterns using matplotlib, by specifying the sequences of colors in the vertical and horizontal bands.
+
+## usage
+Will come soon.
+
+## examples
+![WDrsguMvrZAemBbPmjvpCpmNaUlpUVGo](https://github.com/user-attachments/assets/cd24fe8c-bf68-4069-a3b5-0185acb0cfbe)
+
+![volDSxcHNHzKmonqDtFZTrYUtwLrkEEo](https://github.com/user-attachments/assets/7908c059-5830-4185-a30e-f4a29195ff45)
+
+![FGnjxjoIdephzvXkjlegPmjIZAsqxWGF](https://github.com/user-attachments/assets/0d14f2bc-68d8-49d5-bde2-14957bdb01ab)