diff --git a/searx/static/themes/oscar/README.rst b/searx/static/themes/oscar/README.rst
index e7daa871..1a226bc2 100644
--- a/searx/static/themes/oscar/README.rst
+++ b/searx/static/themes/oscar/README.rst
@@ -15,3 +15,42 @@ run this command in the directory ``searx/static/themes/oscar``
 or in the root directory:
 
 ``make grunt``
+
+directory structure
+~~~~~~~~~~~~~~~~~~~
+
+see:
+
+- gruntfile.js
+- package.json
+
+*************
+css directory
+*************
+
+- ``bootstrap*``: bootstrap NPM package,
+- ``leaflet.*``: leaflet NPM package
+- ``leaflet.min.css``: minimized version of ``leaflet.css`` (see gruntfile.js)
+- ``logicodev.*``: compiled from ``src/less/logicodev``
+- ``logicodev-dark*``: compiled from ``src/less/logicodev-dark``
+- ``pointhi*``: compiled from ``src/less/pointhi``
+- ``images``: leaflet NPM package
+
+**************
+font directory
+**************
+
+- from bootstrap NPM package
+
+************
+js directory
+************
+
+- ``searx.*``: compiled from ``src/js``
+- other files are from NPM packages
+
+*************
+img directory
+*************
+
+- images for the oscar theme