diff --git a/docs/THEMES.md b/docs/THEMES.md
new file mode 100644
index 0000000000..6b06a18fd2
--- /dev/null
+++ b/docs/THEMES.md
@@ -0,0 +1,25 @@
+# App color themes
+
+Mobile apps allow to configure, export and import color themes. Currently this is only supported in Android app.
+
+You can contribute your themes to the repository by creating a pull request.
+
+## How to contribute a theme
+
+1. Once you have configured your theme in the app, export it to a file and give it a descriptive name – e.g., `example.theme`
+
+2. Export your app database, and import a [sample chat database](./themes/simplex-chat.sample.zip).
+
+3. Make three screenshots - the list of conversations with opened profile picker, conversation and privacy settings.
+
+4. Create PR that includes these files and amends this THEMES.md file, following the example below.
+
+5. Restore your database from the backup.
+
+## Color themes
+
+### SimpleX - included dark blue theme
+
+Download [SimpleX theme](./themes/example.theme)
+
+<img src="./themes/example-chats.png" width="240"> &nbsp;&nbsp; <img src="./themes/example-conversation.png" width="240"> &nbsp;&nbsp; <img src="./themes/example-settings.png" width="240"> &nbsp;&nbsp;
diff --git a/docs/themes/example-chats.png b/docs/themes/example-chats.png
new file mode 100644
index 0000000000..15527729e6
Binary files /dev/null and b/docs/themes/example-chats.png differ
diff --git a/docs/themes/example-conversation.png b/docs/themes/example-conversation.png
new file mode 100644
index 0000000000..3d40293957
Binary files /dev/null and b/docs/themes/example-conversation.png differ
diff --git a/docs/themes/example-settings.png b/docs/themes/example-settings.png
new file mode 100644
index 0000000000..3b57c44cf9
Binary files /dev/null and b/docs/themes/example-settings.png differ
diff --git a/docs/themes/example.theme b/docs/themes/example.theme
new file mode 100644
index 0000000000..29c48c0f4d
--- /dev/null
+++ b/docs/themes/example.theme
@@ -0,0 +1,11 @@
+base: "SIMPLEX"
+colors:
+  accent: "#ff70f0f9"
+  accentVariant: "#ff1298a5"
+  secondary: "#ff8b8786"
+  secondaryVariant: "#ff2c464d"
+  background: "#ff111528"
+  menus: "#ff121c37"
+  title: "#ff267be5"
+  sentMessage: "#1e45b8ff"
+  receivedMessage: "#20b1b0b5"
\ No newline at end of file
diff --git a/docs/themes/simplex-chat.sample.zip b/docs/themes/simplex-chat.sample.zip
new file mode 100644
index 0000000000..048bfd9684
Binary files /dev/null and b/docs/themes/simplex-chat.sample.zip differ