ScavoldVitePress theme framework

Handles the structural plumbing of content-driven websites so you can focus on design.

Page hierarchy

Scavold builds a tree of all pages at build time and exposes it client-side via useHierarchy(). Navigation components derive their items directly from this tree — no manual config.

Responsive images

Local images are automatically processed by sharp into WebP variants with srcset and sizes. Nothing to configure per image.

Multilingual

Set locale once on a section's index.md and it propagates to all child pages. The locale switcher links to counterpart pages via the translations frontmatter key.

Markdown containers

Fenced ::: blocks map to Vue components. Built-in sectioning elements plus any custom containers you declare in .cratly.config.yaml.

Redirects

Declare redirect in frontmatter. Unconditional redirects become VitePress rewrites; locale-conditional ones run client-side with a noscript fallback.

URL aliases

Move a page to a cleaner URL without touching the source folder structure. Declare url in frontmatter; Scavold generates the VitePress rewrite and updates all navigation links.

Part of cratly

Scavold is the reference adapter of cratly — a way of running a website whose content lives in a git repository while the people writing it work in a browser. cratly defines the formats: what .cratly.config.yaml declares about a site, and what an editor may offer for each kind of section. Scavold turns a repository following them into a static site.

Neither needs the other. A site built with Scavold works whether or not an editor ever touches it, and the formats are deliberately framework-agnostic, so adapters for other frameworks can implement them too.