diff --git a/README.md b/README.md
index 0949742..fc717ec 100644
--- a/README.md
+++ b/README.md
@@ -16,9 +16,9 @@ shell, native settings, live-reloading themes and wallpapers, desktop widgets,
fluid animations, and scrolling and tiling layouts work together as one
cohesive experience—beautiful by default and unmistakably yours.
-
+
-## One cohesive desktop
+## Why Ferese
- **Flexible layouts:** scrolling columns, tree tiling, floating windows and a
workspace overview.
@@ -31,6 +31,11 @@ cohesive experience—beautiful by default and unmistakably yours.
- **Screen sharing:** a native display picker and PipeWire video streams for
portal-compatible recording and conferencing apps.
+
+
+The overview brings windows and workspaces into one view. Read more about
+[why Ferese builds the compositor and shell together](docs/why-ferese.md).
+
## Make it yours
Use the native Settings app for everyday customization, or edit
@@ -38,7 +43,7 @@ Use the native Settings app for everyday customization, or edit
changes as you make them and keeps the last working configuration if an edit is
invalid.
-
+
Choose a preset or build your own look. Window behavior, gestures, shortcuts,
rules, displays, widgets and login items are configurable too. Start with the
diff --git a/docs/images/ferese-desktop.png b/docs/images/ferese-desktop.png
index 3826c84..06af81c 100644
Binary files a/docs/images/ferese-desktop.png and b/docs/images/ferese-desktop.png differ
diff --git a/docs/images/ferese-desktop.webp b/docs/images/ferese-desktop.webp
new file mode 100644
index 0000000..3ef5cd5
Binary files /dev/null and b/docs/images/ferese-desktop.webp differ
diff --git a/docs/images/ferese-gruvbox.webp b/docs/images/ferese-gruvbox.webp
new file mode 100644
index 0000000..34b1afe
Binary files /dev/null and b/docs/images/ferese-gruvbox.webp differ
diff --git a/docs/images/ferese-monochrome.png b/docs/images/ferese-monochrome.png
deleted file mode 100644
index b32c867..0000000
Binary files a/docs/images/ferese-monochrome.png and /dev/null differ
diff --git a/docs/images/ferese-overview.webp b/docs/images/ferese-overview.webp
new file mode 100644
index 0000000..8d75a18
Binary files /dev/null and b/docs/images/ferese-overview.webp differ
diff --git a/docs/why-ferese.md b/docs/why-ferese.md
index 7ce8b28..d5f8388 100644
--- a/docs/why-ferese.md
+++ b/docs/why-ferese.md
@@ -43,6 +43,8 @@ widgets, and native lock screen together. Managed windows have their own radius
because they are a different kind of surface, but each value still has one clear
meaning wherever it is used.
+
+
In an assembled desktop, making the same visual change may mean editing the
window manager, bar CSS, launcher theme, notification daemon, and lock screen
config separately, then keeping those values aligned as the setup changes.
@@ -53,6 +55,8 @@ the compositor, and builds the overview from the real window scene. Focus,
fullscreen, workspace geometry, and input all work from the same state rather
than waiting for separate tools to catch up with one another.
+
+
When a window opens, Ferese can handle the result as one transition:
```text
diff --git a/scripts/build-site.py b/scripts/build-site.py
index 81eec27..2202965 100644
--- a/scripts/build-site.py
+++ b/scripts/build-site.py
@@ -27,8 +27,7 @@ for name in ('index.html', 'styles.css', 'app.js'):
shutil.copy2(ROOT / 'site' / name, OUTPUT / name)
(OUTPUT / 'assets').mkdir(exist_ok=True)
shutil.copytree(ROOT / 'site/assets', OUTPUT / 'assets', dirs_exist_ok=True)
-for name in ('ferese-desktop.png', 'ferese-monochrome.png'):
- shutil.copy2(ROOT / 'docs/images' / name, OUTPUT / 'assets' / name)
+shutil.copytree(ROOT / 'docs/images', OUTPUT / 'assets', dirs_exist_ok=True)
shutil.copy2(ROOT / 'packaging/icons/ferese.svg', OUTPUT / 'assets/ferese.svg')
(OUTPUT / 'docs').mkdir(exist_ok=True)
(OUTPUT / '.nojekyll').touch()
@@ -71,6 +70,16 @@ for page_number, (slug, title, source) in enumerate(PAGES):
for child in token.children or []:
if child.type == 'link_open':
child.attrSet('href', rewrite_link(child.attrGet('href'), source))
+ elif child.type == 'image':
+ image = urlsplit(child.attrGet('src'))
+ if not image.scheme and not image.netloc:
+ path = (source.parent / image.path).resolve()
+ relative = path.relative_to(ROOT / 'docs/images')
+ if not path.is_file():
+ raise FileNotFoundError(path)
+ child.attrSet('src', f'../assets/{relative.as_posix()}')
+ child.attrSet('loading', 'lazy')
+ child.attrSet('decoding', 'async')
search_index.extend(sections)
body = md.renderer.render(tokens, md.options, {})
body = body.replace('
