Autolith website

Static HTML generated with Common Lisp and HSX. The browser receives HTML, CSS and plain ES modules. Node is used only for tests.

Edit

• content/*.sexp: page copy, one file per section. Keys match calls in the corresponding src/sections/*.lisp component.
• content/site.sexp: page title, description, canonical URL and shared links.
• content/commands.sexp: shared installation commands.
• src/components.lisp: navigation, command blocks and decorative figures.
• src/sections/: HSX section components, including diagrams and code examples.
• src/page.lisp: page metadata and section order.
• public/: files copied to the output, including CSS, JS, fonts and recordings.
• vendor/: pinned Lisp source dependencies and licenses.

Copy files are data, read with reader evaluation disabled. Use strings and a small inline vocabulary: :em, :strong, :b, :i, :code, :kbd, :span, :a, and :br. Each inline element has an attribute list followed by children:

(:title ("A live " (:em () "Common Lisp") " agent")
 :prose ("Read the " (:a (:href "https://github.com/lambda-symbolics/autolith")
                       "source") "."))

Missing keys, duplicate keys, invalid markup and unreadable data fail the build. Use HSX for layout and reusable components; use copy files for prose. Org-mode conversion is unnecessary for this page.

Build

./script/build

Serve dist/ with any static HTTP server. A source build uses SBCL on PATH. On Linux x86-64 without SBCL, the bootstrap downloads the pinned SBCL 2.4.0 binary, verifies its SHA-256 and installs it under .cache/. All Lisp library sources are vendored, so no Quicklisp setup or dependency download is needed. Downloading the runtime requires curl, tar, bzip2 and sha256sum. On other platforms, install SBCL first.

SITE_DOWNLOAD_SBCL=1 ./script/build

Use that command to exercise the downloadable runtime even with a local SBCL. This binary supports glibc 2.34, as provided on Vercel's build host. Local page generation takes about 15 ms; runtime download and initial compilation add several seconds. Build caches are disposable; content is read afresh on every invocation. Only dist/ is published.

Check

npm ci
npx playwright install chromium
./script/check

With an existing Chromium, use CHROMIUM=/path/to/chromium ./script/check. Checks cover copy validation, escaping, deterministic HTML, JS syntax, internal anchors, desktop and mobile rendering, keyboard tabs and navigation, motion preferences, no-JavaScript content and automated WCAG A/AA checks with axe. Screenshots are written to test-results/ for visual review. Automated checks do not constitute an accessibility certification.

Browser code

public/js/main.js initializes independent enhancements. Navigation and tabs are separate from the reader demonstration, diagrams, tower and decorative figures. The reader demonstrates prompt syntax; it does not execute Lisp. The asciinema player is downloaded only when a recording is requested.

The palette is black ink on off-white #fffefa, with green accents and one-bit dither. The footer is inverted. Animations run by default regardless of system motion preferences. Core copy and installation panels are available without JavaScript. ?still=1 selects static figures, ?stage=0|1|2 selects a reader-morph stage, and ?t=<seconds> advances the tower for a capture.

Deploy

The existing Vercel project is autolith-www, currently at autolith-www.vercel.app. vercel.json selects the Other framework, ./script/build, and dist/. The install step deliberately skips test-only npm dependencies.

vercel link --project autolith-www
vercel deploy --prod --yes

Keep .vercel/ local. Update the URL in content/site.sexp when assigning a permanent domain. Build duration and total deployment latency are separate.

Assets and provenance

Fonts, logos and artwork were carried over from the existing site, originally sourced from lambda-symbolics/ls-landing. The recordings and asciinema player are also retained. Dependency versions and licenses are listed in vendor/README.md. Repository practices in AGENTS.md are adapted from Autolith.