diff --git a/README.md b/README.md
index f01540291..8ab0365ce 100644
--- a/README.md
+++ b/README.md
@@ -5,11 +5,6 @@ Alert dashboard for
---
-Release notes can be found on
-[GitHub Release Page](https://github.com/prymitive/karma/releases).
-
----
-
Alertmanager `0.16.x` is **NOT** supported by karma due to changes
in the API, see [this issue](https://github.com/prymitive/karma/issues/115)
for details.
@@ -19,8 +14,13 @@ alertmanager `>=0.17.0` is supported.
---
+## Feature overview
+
Alertmanager UI is useful for browsing alerts and managing silences, but it's
lacking as a dashboard tool - karma aims to fill this gap.
+
+### Alert aggregation and deduplication
+
Starting with the `0.7.0` release it can aggregate alerts from multiple
Alertmanager instances, running either in HA mode or separate. Unique alerts are
displayed by filtering duplicates. Each alert is tagged with the names of all
@@ -30,6 +30,8 @@ is configured with multiple Alertmanager instances.

+### Alert visualization
+
Alerts are displayed grouped preserving
[group_by](https://prometheus.io/docs/alerting/configuration/#route)
configuration option in Alertmanager. If a group contains multiple alerts only
@@ -48,27 +50,49 @@ screen space, the silence will also be moved to the footer.

+### Silence management
+
Silence modal allows to create new silences and manage all silences already
present in Alertmanager.

+### Alert overview
+
Clicking on the alert counter in the top left corner will open the overview
modal, which allows to quickly get an overview of the top label values for
all current alerts.

+### Alert acknowledgement
+
Starting with `v0.50` karma can create short lived silences to acknowledge
alerts with a single button click. To create silences that will resolve itself
only after all alerts are resolved you can use
[kthxbye](https://github.com/prymitive/kthxbye).
See [configuration docs](/docs/CONFIGURATION.md#alert-acknowledgement) for
-details. Example:
+details.
-
+### Dark mode
-[Online demo](https://karma-demo.herokuapp.com/)
+Starting with `v0.51` release karma includes both light and dark themes.
+By default it will follow browser preference using
+[prefers-color-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme)
+media queries.
+
+
+
+## Demo
+
+[Online demo](https://karma-demo.herokuapp.com/) is running latest master branch
+or PR branch version. It might include features that are experimental and not
+yet ready to be included.
+
+## Release notes
+
+Release notes can be found on
+[GitHub Release Page](https://github.com/prymitive/karma/releases).
To get notifications about new karma releases go to
[GitHub karma page](https://github.com/prymitive/karma), click `Watch` and
diff --git a/docs/img/ack.gif b/docs/img/ack.gif
deleted file mode 100644
index 84ad500a1..000000000
Binary files a/docs/img/ack.gif and /dev/null differ
diff --git a/docs/img/alertGroup.png b/docs/img/alertGroup.png
index f215de716..ee0799074 100644
Binary files a/docs/img/alertGroup.png and b/docs/img/alertGroup.png differ
diff --git a/docs/img/dark.png b/docs/img/dark.png
new file mode 100644
index 000000000..6de84185e
Binary files /dev/null and b/docs/img/dark.png differ
diff --git a/docs/img/footerSilence.png b/docs/img/footerSilence.png
index 085115676..6df38449e 100644
Binary files a/docs/img/footerSilence.png and b/docs/img/footerSilence.png differ
diff --git a/docs/img/overview.png b/docs/img/overview.png
index e33524ccb..fabc43ca8 100644
Binary files a/docs/img/overview.png and b/docs/img/overview.png differ
diff --git a/docs/img/screenshot.png b/docs/img/screenshot.png
index 338668bc6..fdbb3c540 100644
Binary files a/docs/img/screenshot.png and b/docs/img/screenshot.png differ
diff --git a/docs/img/silenceBrowser.png b/docs/img/silenceBrowser.png
index f3453346b..a33869473 100644
Binary files a/docs/img/silenceBrowser.png and b/docs/img/silenceBrowser.png differ
diff --git a/ui/src/Components/MainModal/Configuration/__snapshots__/ThemeConfiguration.test.js.snap b/ui/src/Components/MainModal/Configuration/__snapshots__/ThemeConfiguration.test.js.snap
index e9fc0d99d..e4ed73342 100644
--- a/ui/src/Components/MainModal/Configuration/__snapshots__/ThemeConfiguration.test.js.snap
+++ b/ui/src/Components/MainModal/Configuration/__snapshots__/ThemeConfiguration.test.js.snap
@@ -7,7 +7,7 @@ exports[`