Update branding

Update the Ferese symbols, appearance-specific wallpapers, and rounded wallpaper and theme previews. Bundle Figtree and add the Ferese name to the website header.

Verified configuration, theme, Settings, wallpaper and installer tests, both UI renderers, the static site build, and browser layouts.

scripts/build-site.py

@@ -33,7 +33,7 @@ for name in ('index.html', 'styles.css', 'app.js'):
 (OUTPUT / 'assets').mkdir(exist_ok=True)
 shutil.copytree(ROOT / 'site/assets', OUTPUT / 'assets', dirs_exist_ok=True)
 shutil.copytree(ROOT / 'docs/images', OUTPUT / 'assets', dirs_exist_ok=True)
-shutil.copy2(ROOT / 'packaging/icons/ferese.svg', OUTPUT / 'assets/ferese.svg')
+shutil.copytree(ROOT / 'assets/branding', OUTPUT / 'assets/branding')
 (OUTPUT / 'docs').mkdir(exist_ok=True)
 (OUTPUT / '.nojekyll').touch()
 search_index = []
@@ -103,13 +103,13 @@ for page_number, (slug, title, source) in enumerate(PAGES):
     doc = f'''<!doctype html>
 <html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
 <meta name="theme-color" content="#10151c"><title>{escape(title)} — Ferese handbook</title><meta name="description" content="{escape(title)} in the Ferese handbook: setup, configuration, and guides for your Wayland desktop.">
-<link rel="icon" href="../assets/ferese.svg" type="image/svg+xml"><link rel="stylesheet" href="../styles.css"><script src="../app.js" defer></script></head>
+<link rel="icon" href="../assets/branding/ferese-blue-flat.svg" type="image/svg+xml"><link rel="icon" href="../assets/favicon.ico" sizes="16x16 32x32 48x48"><link rel="icon" href="../assets/favicon-32.png" type="image/png" sizes="32x32"><link rel="stylesheet" href="../styles.css"><script src="../app.js" defer></script></head>
 <body class="docs-page"><a class="skip" href="#main">Skip to content</a>
-<header class="site-header"><div class="header-inner"><a class="wordmark" href="../" aria-label="Ferese home"><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M3 3h6v18H3zM11 3h10v6H11zM11 11h7v6h-7z"/></svg>ferese</a><nav aria-label="Main navigation"><a href="../">Overview</a><a href="./" aria-current="page">Documentation</a><a href="{REPO}">GitHub <svg class="link-arrow" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M7 17 17 7M7 7h10v10"/></svg></a></nav></div></header>
+<header class="site-header"><div class="header-inner"><a class="brand" href="../" aria-label="Ferese home"><img class="brand-icon" src="../assets/branding/ferese-blue-dark.svg" width="1024" height="1024" alt=""><span class="brand-name">Ferese</span></a><nav aria-label="Main navigation"><a href="../">Overview</a><a href="./" aria-current="page">Documentation</a><a href="{REPO}">GitHub <svg class="link-arrow" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M7 17 17 7M7 7h10v10"/></svg></a></nav></div></header>
 <div class="docs-layout"><aside class="docs-sidebar"><div class="docs-search" hidden><label class="sr-only" for="docs-search">Search the handbook</label><input id="docs-search" type="search" placeholder="Search the handbook…" autocomplete="off" aria-controls="search-results"><div class="search-results" id="search-results" hidden></div><p class="sr-only" id="search-status" role="status"></p></div><details open><summary>FERESE HANDBOOK</summary><nav aria-label="Documentation">{navigation}</nav></details><div class="sidebar-links"><a href="{REPO}/issues">Report an issue <svg class="link-arrow" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M7 17 17 7M7 7h10v10"/></svg></a><a href="../">Back to Ferese ←</a></div></aside>
 <main class="docs-article" id="main"><div class="breadcrumb"><a href="./">Handbook</a><span aria-hidden="true">/</span><span>{escape(title)}</span></div><article class="prose">{body}</article><a class="edit-link" href="{REPO}/blob/main/{source.relative_to(ROOT)}">View this guide on GitHub <svg class="link-arrow" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M7 17 17 7M7 7h10v10"/></svg></a><nav class="docs-pager" aria-label="Previous and next guide">{pager}</nav></main>
 <aside class="docs-toc" aria-label="On this page">{'<p>ON THIS PAGE</p><nav>' + contents + '</nav>' if contents else ''}</aside></div>
-<footer class="site-footer page-width"><a class="wordmark" href="../">ferese</a><p>A Wayland desktop with scrolling layouts.</p><a href="{REPO}">Built in the open <svg class="link-arrow" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M7 17 17 7M7 7h10v10"/></svg></a></footer></body></html>'''
+<footer class="site-footer page-width"><a class="brand" href="../" aria-label="Ferese home"><img class="brand-icon" src="../assets/branding/ferese-blue-dark.svg" width="1024" height="1024" alt=""></a><p>A Wayland desktop with scrolling layouts.</p><a href="{REPO}">Built in the open <svg class="link-arrow" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M7 17 17 7M7 7h10v10"/></svg></a></footer></body></html>'''
     (OUTPUT / 'docs' / f'{slug}.html').write_text(doc)
 (OUTPUT / 'docs/search-index.json').write_text(json.dumps(search_index, ensure_ascii=False))
 print(f'Built website and {len(PAGES)} handbook pages at {OUTPUT}')

scripts/installer/install.py

@@ -143,6 +143,10 @@ def validate_bundle(bundle):
     for item in manifest['files']:
         target = item['target']
         allowed = expected.get(target)
+        # Older releases bundled this retired source asset. Keep their manifests
+        # verifiable for upgrades and rollback without adding it to new bundles.
+        if allowed is None and target == 'wallpapers/ferese.svg':
+            allowed = {'target': target, 'mode': '0644'}
         if allowed is None and re.fullmatch(r'licenses/theme-[A-Za-z0-9._-]+\.txt', target):
             allowed = {'target': target, 'mode': '0644'}
 

scripts/installer/inventory.json

@@ -101,8 +101,13 @@
       "mode": "0644"
     },
     {
-      "source": "assets/wallpapers/ferese.svg",
-      "target": "wallpapers/ferese.svg",
+      "source": "assets/wallpapers/ferese-wallpaper-dark.jpg",
+      "target": "wallpapers/ferese-wallpaper-dark.jpg",
+      "mode": "0644"
+    },
+    {
+      "source": "assets/wallpapers/ferese-wallpaper-light.png",
+      "target": "wallpapers/ferese-wallpaper-light.png",
       "mode": "0644"
     },
     {

scripts/tests/test_portal_install.py

@@ -127,6 +127,31 @@ m.main()
         self.assertEqual(os.readlink(self.base / 'previous'), 'releases/second')
         self.assertEqual([(self.root / path).read_bytes() for path in (PORTAL, UNIT, DESKTOP)], first)
 
+    def test_upgrade_and_rollback_accept_retired_wallpaper_svg_with_verified_checksum(self):
+        legacy = Path(self.temporary.name) / 'legacy'
+        shutil.copytree(self.bundles[0], legacy)
+        svg = legacy / 'wallpapers/ferese.svg'
+        svg.write_text('<svg xmlns="http://www.w3.org/2000/svg"/>\n')
+        svg.chmod(0o644)
+        manifest_path = legacy / 'manifest.json'
+        manifest = json.loads(manifest_path.read_text())
+        manifest['files'].append({'target': 'wallpapers/ferese.svg', 'mode': '0644',
+                                  'sha256': installer.digest(svg)})
+        manifest_path.write_text(json.dumps(manifest))
+
+        self.run_command('install', legacy)
+        self.assertTrue((self.base / 'current/wallpapers/ferese.svg').is_file())
+        self.install(1)
+        self.assertEqual(os.readlink(self.base / 'current'), 'releases/second')
+        self.assertFalse((self.base / 'current/wallpapers/ferese.svg').exists())
+        self.run_command('rollback')
+        self.assertEqual(os.readlink(self.base / 'current'), 'releases/first')
+        self.assertEqual((self.base / 'current/wallpapers/ferese.svg').read_bytes(), svg.read_bytes())
+
+        svg.write_text('corrupt legacy wallpaper')
+        with self.assertRaisesRegex(ValueError, 'Checksum mismatch: wallpapers/ferese.svg'):
+            installer.validate_bundle(legacy)
+
     def test_upgrade_uses_previous_installer_ownership_receipts(self):
         self.install()
         release = self.base / 'releases/first'