diff --git a/README.md b/README.md
index a665ca2..5c86ccf 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,13 @@
 # dotfiles
 
+<p align="center">
+  <img src="website/assets/images/dotfiles-readme-banner.png" alt="fnayou/dotfiles banner" />
+</p>
+
+<p align="center">
+  <a href="https://fnayou.github.io/dotfiles/">Documentation</a>
+</p>
+
 Private, safe, cross-platform personal dotfiles for **macOS** and **EndeavourOS / Arch Linux**,
 managed with [GNU Stow](https://www.gnu.org/software/stow/).
 
@@ -7,8 +15,6 @@ macOS is the primary environment; Arch is supported from the start. Configs are
 in `stow/common/` and only ever symlinked into `$HOME` by a **deliberate, manual** Stow step —
 never automatically.
 
-📖 **Documentation site:** <https://fnayou.github.io/dotfiles/>
-
 ## Status
 
 ```
diff --git a/mkdocs.yml b/mkdocs.yml
index 391946b..80cc411 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -8,6 +8,8 @@ docs_dir: website
 
 theme:
   name: material
+  logo: assets/images/dotfiles-logo.png
+  favicon: assets/images/favicon.png
   palette:
     scheme: slate
     primary: blue
diff --git a/website/assets/images/dotfiles-logo.png b/website/assets/images/dotfiles-logo.png
new file mode 100644
index 0000000..3854ff3
Binary files /dev/null and b/website/assets/images/dotfiles-logo.png differ
diff --git a/website/assets/images/dotfiles-readme-banner.png b/website/assets/images/dotfiles-readme-banner.png
new file mode 100644
index 0000000..92f64d8
Binary files /dev/null and b/website/assets/images/dotfiles-readme-banner.png differ
diff --git a/website/assets/images/dotfiles-social-preview.png b/website/assets/images/dotfiles-social-preview.png
new file mode 100644
index 0000000..2f9ac2e
Binary files /dev/null and b/website/assets/images/dotfiles-social-preview.png differ
diff --git a/website/assets/images/favicon.png b/website/assets/images/favicon.png
new file mode 100644
index 0000000..0accc26
Binary files /dev/null and b/website/assets/images/favicon.png differ