Vibium Website

Browser automation for AI agents and humans, built on WebDriver BiDi.

This repository contains the user-facing Vibium website and documentation. The homepage is an Astro page at /, while the documentation is published under /docs/.

The docs are plain Markdown so they render well on GitHub, in Starlight, and inside an agent context window.

Contents

• Introduction
• Installation
• Quickstart — a few lines, copy-paste.
• Getting Started — the mental model.
• Tutorial: Filling a Form End-to-End — a worked example.
• Core Concepts
• Command Reference
• MCP Server Integration
• Client Libraries
• Troubleshooting
• FAQ
• Contributing

Site generation

The top-level Makefile is the build entrypoint:

• make build regenerates public LLM docs, syncs Markdown and MDX into Starlight, builds the static site in site/dist/, and postprocesses the generated output for agent-readable surfaces.
• make rebuild removes generated site output first, then runs the full build.
• make serve regenerates content and starts the local Astro dev server.
• make test builds the site and verifies the homepage, /docs/ routes, root LLM assets, agent-readable generated files, and Google Analytics wiring.
• make clean removes generated output listed in scripts/clean-manifest.txt and deletes stray .DS_Store files.

Edit the homepage in site/src/pages/index.astro. Edit canonical docs content in README.md and docs/; scripts/sync_starlight.py copies those files into Starlight under /docs/.

Edit canonical brand imagery in site/src/assets/brand/ and landing page imagery in site/src/assets/landing/. The favicon files in site/public/ are stable served assets.

The generated site/public/llms.txt is a spec-compliant index served at /llms.txt; it links to Markdown copies of the docs under /llms/. The generated site/public/llms-full.txt keeps the single-file context form for agents that prefer one large document.

scripts/postprocess_site.py runs after Astro builds. It writes same-path Markdown mirrors into site/dist/, adds language classes to generated code blocks, adds <lastmod> values to the XML sitemap, and publishes site/dist/sitemap.md.

Agent readability

The badge above reflects the latest live https://vibium.com/ a14y site audit. To check unpublished changes locally, build with a localhost SITE_URL, preview the static output, and run the site audit against that preview:

SITE_URL=http://127.0.0.1:4323 make build
pnpm --dir site exec astro preview --host 127.0.0.1 --port 4323
npx -y a14y check http://127.0.0.1:4323/ --mode site --output agent-prompt --max-pages 200

After deployment, refresh the badge with the Embed badge: URL printed by:

npx -y a14y check https://vibium.com/ --mode site --max-pages 200