The website for Meitheal, a Kubernetes-native harness
for agentic coding. SvelteKit with Svelte 5 runes, Tailwind CSS v3, prerendered to static HTML
with @sveltejs/adapter-static, and deployed on Netlify the same way llmkube.com is.
The site has two parts: a homepage, and /docs, rendered at build time from the Meitheal
repository's docs/ directory. DESIGN.md is the design system (shared with llmkube.com).
Node 20.19 or later (Vite 7 needs it).
npm install
npm run dev # http://localhost:5173
npm run build # writes build/
npm run preview # serves build/ on http://localhost:4173
npm run check # svelte-check, 0 errors expecteddev, build and check all fetch and render the docs first (below).
npm run docs:sync runs two scripts:
-
scripts/fetch-docs.shshallow-cloneshttps://github.com/defilantech/meitheal.git(main) into.docs-cache/meitheal. To render a local checkout instead, including whatever branch it has out, setMEITHEAL_DOCS_LOCAL_PATH; the cache becomes a symlink to it:MEITHEAL_DOCS_LOCAL_PATH=~/code/meitheal npm run dev -
scripts/render-docs.jscopies each page listed insrc/lib/docs/nav.jsintosrc/content/docs/, where mdsvex compiles it. It fills in a missing title and description, rewrites the GitHub-style links between docs into site routes (anything else in the repo links to GitHub), and copies the images the pages reference intostatic/docs-images/.
The Meitheal docs have no nav file, so the sidebar lives here, in src/lib/docs/nav.js: add
a page there to publish it. A listed page whose markdown is missing upstream is skipped with a
warning, not a failed build. docs/proposals and docs/superpowers are internal history and
stay out.
.docs-cache/, src/content/docs/ and static/docs-images/ are generated and gitignored.
npm run build && npm run test:links # every internal link, anchor and asset in build/
npm run preview & # the next three need the preview server on :4173
npm run test:a11y # pa11y-ci, axe + HTML_CodeSniffer, WCAG 2 AA
npm run test:reflow # no page scrolls sideways at 320px
node scripts/contrast-report.mjs # what axe measured per element
npm run contrast:tokens # the contrast tables in DESIGN.mdThe prerender crawl fails the build on a link to a missing page or anchor, so a broken link in the Meitheal docs shows up as a failed build, not on the live site.
npm run og:render re-renders the social card (static/og-image.png) from
social/og-default.html. It and the a11y scripts use the Puppeteer that pa11y-ci installs.
netlify.toml holds the build settings: npm run build, publish build, Node 20, and
X-Robots-Tag: noindex on deploy previews and branch deploys only. The production build clones
the Meitheal repo's main, so the live docs follow main and change only when the site is
rebuilt.
To set it up:
- Push this repository to GitHub (for example
defilantech/meitheal-web). - In Netlify, Add new site, Import an existing project, pick the repository. Netlify reads
netlify.toml; check that the build command isnpm run buildand the publish directory isbuild, and leave the environment empty (MEITHEAL_DOCS_LOCAL_PATHis for local use only). - Domain management, Add a domain:
meitheal.dev, then addwww.meitheal.dev. Point DNS at Netlify (Netlify DNS, or anA/ALIASrecord for the apex and aCNAMEforwwwat your registrar). Netlify redirects whichever of the two is not primary to the primary one; makemeitheal.devprimary. - HTTPS: once DNS resolves, Netlify provisions a Let's Encrypt certificate for both names.
Turn on Force HTTPS.
.devis on the HSTS preload list, so the site only ever loads over HTTPS anyway. - Optional: a build hook, triggered from the Meitheal repo when
docs/changes onmain, keeps the live docs current without a commit here.
There are no analytics on the site.