Skip to content

About

Website for Meitheal, a Kubernetes-native harness for agentic coding

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

meitheal.dev

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).

Local development

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 expected

dev, build and check all fetch and render the docs first (below).

Docs from the Meitheal repository

npm run docs:sync runs two scripts:

  1. scripts/fetch-docs.sh shallow-clones https://github.com/defilantech/meitheal.git (main) into .docs-cache/meitheal. To render a local checkout instead, including whatever branch it has out, set MEITHEAL_DOCS_LOCAL_PATH; the cache becomes a symlink to it:

    MEITHEAL_DOCS_LOCAL_PATH=~/code/meitheal npm run dev
  2. scripts/render-docs.js copies each page listed in src/lib/docs/nav.js into src/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 into static/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.

Checks

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.md

The 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.

Deploying on Netlify

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:

  1. Push this repository to GitHub (for example defilantech/meitheal-web).
  2. In Netlify, Add new site, Import an existing project, pick the repository. Netlify reads netlify.toml; check that the build command is npm run build and the publish directory is build, and leave the environment empty (MEITHEAL_DOCS_LOCAL_PATH is for local use only).
  3. Domain management, Add a domain: meitheal.dev, then add www.meitheal.dev. Point DNS at Netlify (Netlify DNS, or an A/ALIAS record for the apex and a CNAME for www at your registrar). Netlify redirects whichever of the two is not primary to the primary one; make meitheal.dev primary.
  4. HTTPS: once DNS resolves, Netlify provisions a Let's Encrypt certificate for both names. Turn on Force HTTPS. .dev is on the HSTS preload list, so the site only ever loads over HTTPS anyway.
  5. Optional: a build hook, triggered from the Meitheal repo when docs/ changes on main, keeps the live docs current without a commit here.

There are no analytics on the site.

About

Website for Meitheal, a Kubernetes-native harness for agentic coding

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages