Skip to content

Redesign the website with direct downloads, and fix the Linux AppImage build - #24

Merged
aryanjsx merged 3 commits into
mainfrom
site/redesign
Nov 1, 2026
Merged

aryanjsx merged 3 commits into
mainfrom
site/redesign

Conversation

@aryanjsx

@aryanjsx aryanjsx commented Nov 1, 2026

Copy link
Copy Markdown
Owner

Summary

Three changes:

  1. A new website home page with a download button that picks the right installer for the visitor's system.
  2. A README update to match it.
  3. A fix for the Linux AppImage build failure.

Website (docs/overrides/home.html, docs/stylesheets/home.css, docs/javascripts/home.js)

  • Layout: replaces the docs-style home page with a dedicated landing page: what Locus is for, how first launch works, privacy, downloads, and links into the docs. Docs pages are unchanged.
  • Privacy: uses system fonts only and makes no third-party requests except the GitHub API for download links. Material's JavaScript bundle isn't loaded on this page, since it has no search, tabs or sidebar and the bundle errors without Material's header. Light and dark themes follow the docs' colour scheme.
  • Download button:
    • OS detection: detects Windows, Windows on ARM (via User-Agent Client Hints), macOS and Linux.
    • Direct links: links straight to the installer from the newest desktop-v* release, so the download starts without opening GitHub.
    • Fallbacks: if the newest release lacks a platform, it offers the newest release that has it. Phones get a pointer to the desktop downloads. Without JavaScript, or if the API is unavailable, links open the latest release page.
  • Downloads table: every platform with file sizes, plus notes on unsigned-installer prompts, memory guidance and command-line installs.
  • Also:
    • a favicon matching the Locus mark
    • the hard-coded v1.0.0 version badge is removed from the docs header

README

  • Download link: a download link under the title. The website's download button is now the main way to get the desktop app.
  • Requirements: supported system versions and memory guidance, matching the site.
  • Docs link: now points at the installation guide.

Linux AppImage fix (.github/workflows/desktop.yml)

The edge build after #23 got past the earlier issues, then failed in linuxdeploy with Could not find dependency: libggml-base.so.0. Ollama's bundled libraries find each other through the library path Ollama sets at runtime rather than an rpath, so linuxdeploy couldn't resolve them. The Linux packaging step now sets LD_LIBRARY_PATH to the bundled runtime.

Testing

  • Local preview: I previewed the home page with mkdocs serve at desktop (1280 px) and phone (375 px) widths, in light and dark themes, with no console errors.
  • Live release data: against the published releases, the Windows button links to desktop-v1.0.5/Locus_1.0.5_x64-setup.exe. Linux and Windows ARM fall back to their 1.0.4 files, since 1.0.5 doesn't include them.
  • Linux fix: desktop.yml parses. The AppImage fix only runs in release builds, so the edge build after merge is its first real test.

- Replace the docs-style home page with a dedicated landing page: what
  Locus does, how first launch works, privacy, downloads and docs. It
  uses system fonts only and loads nothing from third parties except the
  GitHub API for download links.
- The download button detects the visitor's system (including Windows
  on ARM) and links straight to the installer from the newest desktop
  release, so the download starts without opening GitHub. If a platform
  is missing from the newest release, it offers the newest one that has
  it. Without JavaScript the links open the latest release page.
- Add a downloads table for every platform with file sizes, plus notes
  on unsigned-installer prompts and command-line installs.
- Add a favicon matching the Locus mark, and drop the hard-coded version
  badge from the docs header, which showed v1.0.0.
- Add a download link under the title and make the website's
  OS-aware download button the main way to get the desktop app.
- List supported system versions and memory guidance, matching the site.
- Point the Docs link at the installation guide instead of the home page.
The Linux AppImage failed with "Could not find dependency:
libggml-base.so.0". Ollama's libraries find each other through the
library path Ollama sets at runtime rather than an rpath, so linuxdeploy
couldn't resolve them. Point LD_LIBRARY_PATH at the bundled runtime for
the Linux packaging step.
@aryanjsx
aryanjsx merged commit f77a041 into main Nov 1, 2026
23 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant