diff --git a/README.md b/README.md
index b54d7e4..49e596e 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,25 @@
# aurora
-Minimal blog theme built with Astro, mainly focused on accessibility and usability.
+## About
+
+aurora is a minimal blog theme built with Astro, Svelte and plain CSS. It is focused on accessibility and usability.
+
+All the interactiveness of the website is packed into three dropdowns that are located at the right of the top navigation bar. Every menu can be opened with a simple keyboard shortcut:
+
+- Table of **c**ontents: **Shift + c**
+- **S**earch for an article: **Shift + s**
+- **T**heme toggle: **Shift + t**
+
+The styles are simple, there are small improvements for some elements to keep everything consistent and responsive.
+
+### Table of contents
+
+Secondary headings (`
`) are listed here, so each page is easy to navigate.
+
+### Search
+
+I wrote a simple algorithm for the search, and the matching works well. You can write the blog title words in any order, leave letters out, have multiple spaces between words, and more.
+
+### Theme toggle
+
+There are three websites themes: Light, Dark and System (inherits the theme of your browser or operating system).
diff --git a/public/favicon.svg b/public/favicon.svg
index 5039b46..5ab2ddc 100644
--- a/public/favicon.svg
+++ b/public/favicon.svg
@@ -1,10 +1,8 @@
-