Repository navigation
Conversation
vishr
force-pushed
the
feat/site
branch
2 times, most recently
from
October 24, 2026 15:37
7b15f4d to
79b7a65
Compare
vishr
changed the title
vishr
force-pushed
the
feat/site
branch
2 times, most recently
from
October 24, 2026 17:05
f59f0c7 to
baeaf84
Compare
A Starlight site for driga.dev, built from the code where it can be: - cmd/driga-docgen writes the CLI, settings, MCP tools and hooks reference pages from the parser, the settings table, the MCP server and dry-run hook installers; `just docs-check` and the docgen tests fail on a stale page. - llms.txt, llms-full.txt and a Markdown alternate of every page, including the landing page's headings, commands and install line. - Catppuccin Mocha and Latte as in the app, Geist and Geist Mono, one heading scale and focus ring, state colours at 4.5:1 or better. The landing page leads with real-time screen recordings of the shipped binary: the terminal from typing `driga` to an allowed permission prompt, then the same prompt allowed in the browser, then the install command, with a Terminal · Browser · Install chapter bar. Feature sections play tight crops of the same takes, light or dark with the site theme; phones get the Needs-you crop in the hero. - cmd/driga-demo plays scripted sessions into a private temporary data directory: it holds the collector lock, writes the store and runs the real prompt broker, so `driga` and `driga web` read it as a live collector. It never reads the process table, agent files or Git. - site/footage records the TUI with VHS and `driga web` with Playwright (a drawn pointer, both themes), refusing to film unless the viewer reads the demo, and cuts the films with Remotion from film/cut.json. - Videos live in the R2 bucket driga-assets under content-hashed keys, served from assets.driga.dev and listed in src/data/media.json; posters are committed. `just site-footage` re-records, `just site-footage-publish` uploads. Docs follow #58 (one-time macOS notification prompt) and #59 (bare `driga` opens the viewer; no activity, conflicts or --watch). Deployed to Cloudflare Pages by .github/workflows/site.yml. Claude-Session: https://claude.ai/code/session_01T2vtcW6ihn1ywy9vxUq9a4
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documentation site for https://driga.dev, built like the fanout and onebox sites.
Site (
site/, Astro 7.4.2 + Starlight 0.42.7):docs/usage.mdanddocs/machine-health.md.@catppuccin/starlight2.1.0), the same themes as the app, with IBM Plex fonts.llms.txt/llms-full.txt, canonical-URL middleware, and the table, social-card and canonical checks. New: a check of every internal link and anchor.Generated by
cmd/driga-docgen, so these pages cannot drift from the code:cli.NewParseris now shared by--helpand the docs..env.example).tools/list.just docs-checkis part ofjust check; a committed-pages test also enforces it.Deploy:
.github/workflows/site.ymlbuilds on main and deploys to the Cloudflare Pages projectdriga. Before it can deploy, the maintainer needs to:driga;CLOUDFLARE_API_TOKENsecret;driga.dev.It reuses fanout's Cloudflare account ID.
PUBLIC_GA_MEASUREMENT_IDis optional; without it the site has no analytics.Checks:
npm run build(astro check, 21 pages, all output checks),go run ./cmd/driga-docgen --check,just checkand actionlint pass.Follow-ups:
docs/usage.mdanddocs/machine-health.md, and shorten the README to point at the site, once it is live.Landing page and footage (update)
cmd/driga-demowrites a private store, holds the collector lock and runs the real prompt broker;site/footagerecords the TUI with VHS anddriga web(dark and light) with Playwright, then cutssite/public/mediawith Remotion (about 8 MB).just site-footageregenerates everything.drigaopens the viewer; noactivity,conflicts,--watch).https://claude.ai/code/session_01T2vtcW6ihn1ywy9vxUq9a4