Yazelix Nova Site

Source repository for https://nova.yazelix.com, the permanent Yazelix Nova website.

Yazelix is the master brand. Yazelix Nova and Yazelix Eon are parallel product lines with separate architecture, documentation, and release evidence. This repository covers Nova only.

Stack

• Astro
• Starlight
• MDX and Markdown content
• Pagefind search through Starlight
• Playwright smoke tests

ARCHITECTURE.md maps product, route, component, build, verification, deployment, and DNS ownership.

Commands

nix develop
bun install --frozen-lockfile
bun run dev
bun run check:typos
bun run check
bun run build
bun run test:e2e

The pinned development shell supplies Bun, Node.js, the Chromium revision used by Playwright, typo and workflow linters, FFmpeg, and the recording tools. Run the typo, diagnostics, build, and browser-test commands above before submitting site changes. Playwright uses the shell's browser closure and does not download another browser during installation.

The reproducible Nova demo workflow lives in drafts/recordings/. Run nix run .#record-demo to rebuild its MP4 and poster from pinned product, demo-repository, capture-tool, and rendering inputs. Kinestra, pinned in flake.lock, owns the isolated X11 display, window lifecycle, recording and poster helpers. Nova's product pins, appearance and keyboard sequences live in drafts/recordings/record.rs, compiled against the pinned Rust library. nix run .#record-demo -- anima records Mandelbrot followed by predator boids. Each take uses independent public Git checkouts in Kinestra's temporary directory. Nova's source and executable share one pinned revision. The recorder checks source cache origins and rejects tracked or untracked edits. Cached working trees and branches stay untouched when selecting a revision for a take. Inspect a rejected cache under drafts/recordings/.work/sources/ before recording again. nix run .#record-demo -- --check-sources checks source isolation offline, without launching an application or writing media. Each take also uses a private Zellij socket directory. Cleanup waits for its session socket to disappear before Kinestra removes the workspace; failures retain session-cleanup.log there. nix run .#record-demo -- --check-cleanup checks the pinned Zellij runtime with disposable headless sessions and an unresponsive socket, without recording media. Codex uses the public Nova checkout with read-only, process-local settings. The recorder disables every configured MCP server, apps, plugins, hooks, skill instructions and skill search, while retaining the installed CLI's authentication. It rejects project-local .codex configuration and grants trust only to the temporary public checkout. Global configuration and trust entries stay untouched. The sixty take submits its prompt, tours the workspace while Codex runs, and returns to the real answer. A missing or invalid completion fails the take and retains the capture for inspection; the recorder waits up to 60 seconds after the tour, so duration depends on model latency. nix run .#record-demo -- --check-codex checks effective settings, escaped server names and paths, and completion validation offline. The original, session, and sixty takes require an authenticated codex on PATH. The other takes do not launch an agent and require no Codex installation or login. The offline check requires the CLI but no login or model request. Live acceptance belongs in a disposable checkout: sixty writes both draft and historical article media in its working directory. Recording is an x86_64 Linux development tool; it is separate from Nova's installed runtime.

Product Source

The canonical Yazelix repository owns Nova behavior. The site-owned current product record identifies the Stable version and exact Nova revision audited for current instructions, including:

• README.md for the public product and command surface
• docs/installation.md for channels, packages, updates, and Home Manager
• docs/configuration.md for settings and native files
• ARCHITECTURE.md for runtime and ownership boundaries

Media retains the capture revisions recorded in docs/site_shape.md and drafts/media/README.md. The published Nova v1 article records its own source revision.

Update that record after reviewing a Stable promotion. Keep uncertain or unsupported behavior off the site.

Site Shape

The information architecture is documented in docs/site_shape.md. The short version is:

• / stays a compact homepage with product identity, install path, and a few strongest demos
• /features/ owns the focused Nova product tour
• /docs/ starts with the Start guide and continues through the task and reference docs
• /blog/ lists published Nova articles