Samuel Onoja
65fcaef13f
* Integrate panel composition, adaptive sizing, and overflow * Add instance editing controls to panel settings * Add panel group editing and measured composition preview * Reorganize panel settings and add drag-and-drop item editing * Simplify panel settings and place inspectors beside the editor * Refine Panel & Shell settings, previews, and panel rendering * Organize settings navigation and modernize packaged panel config * Support top and bottom panels and refine shell surfaces Add edge-aware settings, previews, popup placement, notifications, margins, and corner rendering. Preserve translucency in notification and dialog controls, and tighten spacing around the clock and display-mode icon. * Add workspace styles and fix Settings text rendering * Make panel allocation independent of measurement order * Normalize panel item settings and visibility * Move shell geometry into each panel * Add independent group surfaces and finalize panel configuration * Keep panel fit checks and restoration consistent with allocation * Reject unknown panel item options and namespace metadata * Reject invalid shell startup configuration and remove old radius fields * Discover workspace application icons in a background task * Remove the panel architecture document and improve reference prose * Let panel media fill available space and improve Settings scrolling * Preserve panel labels across clipped GPU rendering * Use matching alpine lake wallpapers for light and dark modes * Fix panel accessibility and popup lifecycle Apply Reduce Transparency to panel opacity in the shell, compositor, and Settings preview. Reject unknown theme tokens before snapshot substitution and validate the current geometry fields in both consumers. Dismiss popovers and workspace tooltips after panel layout changes. Handle bar pointer exits directly and recover workspace hover after reentry without repeated motion updates. Cover the transitions with regression tests and update the wallpaper dimensions check for the bundled lake defaults. * Use tagged Ferese toolkit fixes * Fix center-only panel spacing and headless text rendering * Bundle native 4K abstract wallpapers for both appearances * Dismiss workspace tooltips before captured pointer dispatch * Verify installed JPEG wallpapers when replacing a release
Ferese website and handbook
The website's handbook is built from the project's Markdown guides, so the website and repository share the same documentation.
Local preview
python3 -m venv .site-venv
.site-venv/bin/pip install -r site/requirements.txt
.site-venv/bin/python scripts/build-site.py
python3 -m http.server 8080 --bind 127.0.0.1 --directory build/site
Open http://localhost:8080 for the homepage or http://localhost:8080/docs/ for the handbook. Rebuild and refresh the browser after changing the site sources or guides.
site/index.htmlandsite/styles.css: homepage and shared visual design.site/content/index.md: handbook introduction.docs/*.md: guides; published pages are listed inscripts/build-site.py.scripts/build-site.py: renders Markdown, resolves links, generates section navigation, previous/next links, and the search index.site/app.js: handbook search and code copying. Reading and navigation work without JavaScript. Search is local to the browser, with no third-party service.
GitHub Pages
Choose Settings → Pages → Source → GitHub Actions to publish through the Pages
workflow. It runs when site or documentation changes reach main; you can also
start it manually. The expected address is https://ferese-wm.github.io/ferese/.
The site uses relative links, including for handbook search, so it also works under the
/ferese/ project path. Each build copies screenshots from docs/images into
build/site, which is ignored by Git.
For deployment setup, follow GitHub’s custom workflow documentation.
Brand assets
assets/branding/ferese.svg is the canonical blue Fe mark used by the README,
website, favicons and installed application icons. Its square 950×950 viewBox is
shared with ferese-symbolic.svg, which uses the same shape and currentColor
for shell and notification icons. Keep both variants in sync.
Regenerate the symbolic icon and raster favicons after updating the canonical SVG:
python3 scripts/update-branding.py
The exporter requires Python PyGObject, Pycairo, Pillow and librsvg. The generated
site/assets/favicon-32.png is 32×32; site/assets/favicon.ico contains 16×16,
32×32 and 48×48 images. They are checked in, so the site build needs no renderer.
The links work at both the site root and the GitHub Pages project path.
The light and dark wallpapers live in assets/wallpapers. Both are
3840×2160 and are bundled by the installer. Ferese selects the matching image
when no custom wallpaper is set. Settings keeps both defaults available below
the current wallpaper preview.
Screenshots live in docs/images/screenshots and are shared by the README and
website. They use lossless WebP at the original 2880×1800 resolution.