diff --git a/README.md b/README.md
index a0831e2..d0faddb 100644
--- a/README.md
+++ b/README.md
@@ -9,10 +9,11 @@ database schema could change at any time. Do not consider it as being
 production ready. However, I am currently using it for my own housing search
 and it is working fine :)
 
-**Note**: For the moment, it requires [this MR on
+**Note**: For the moment, it requires [this MR on
 Weboob](https://git.weboob.org/weboob/devel/merge_requests/31) which has not
 yet been merged.
 
+<img src="doc/img/home.png" width="45%"/> <img src="doc/img/home2.png" width="45%"/>
 
 It uses [Weboob](http://weboob.org/) to get all the housing posts on most of
 the websites offering housings posts, and then offers a bunch of pipelines to
@@ -44,6 +45,31 @@ See the [getting started guide](doc/0.getting_started.md).
 See the [dedicated folder](doc/).
 
 
+## Screenshots
+
+### Home page
+
+Display available flats on a map:
+<img src="doc/img/home.png"/>
+
+And list them with the details in a sortable table:
+<img src="doc/img/home2.png"/>
+
+
+### Details page
+
+Uniform display of the flat information in a dedicated page, with the contact etc:
+
+<img src="doc/img/details.png"/>
+
+
+### Follow flats
+
+Track interesting flats and store them with notes:
+
+<img src="doc/img/followed.png"/>
+
+
 ## OpenData
 
 I am using the following datasets, available under `flatisfy/data_files`,
diff --git a/doc/img/details.png b/doc/img/details.png
new file mode 100644
index 0000000..7e2825f
Binary files /dev/null and b/doc/img/details.png differ
diff --git a/doc/img/followed.png b/doc/img/followed.png
new file mode 100644
index 0000000..286fb44
Binary files /dev/null and b/doc/img/followed.png differ
diff --git a/doc/img/home.png b/doc/img/home.png
new file mode 100644
index 0000000..585ba40
Binary files /dev/null and b/doc/img/home.png differ
diff --git a/doc/img/home2.png b/doc/img/home2.png
new file mode 100644
index 0000000..a8e20e1
Binary files /dev/null and b/doc/img/home2.png differ