# wevm/vocs

Minimal Docs for Agents & Humans.

Repository: https://github.com/wevm/vocs
Canonical: https://ross.abutalabs.com/products/vocs
Homepage: https://vocs.dev
Language: TypeScript
License: MIT
License Family: permissive
Topics: docs, markdown, mdx, react, typescript, vite
Last push: 2026-08-05T10:19:04+00:00

## Health v2 (maintenance only)
Score: 88/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 96, release rhythm 84, longevity 75
- inputs: {"age_days": 1055, "days_push": 28, "days_rel": 28, "gap_med": 0, "n_releases_24m": 84}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1541, forks 123 (observed 2026-08-28T04:05:00.619987+00:00)

## What it is
Vocs is a lightweight documentation framework powered by Vite that turns Markdown and MDX files into rich, navigable docs sites. It is designed so documentation stays simple at the source while remaining consumable by AI agents and humans alike.

## Use cases
- build a documentation site for my open-source library
- write docs in markdown and mdx with a react frontend
- scaffold a docs project with a cli
- publish documentation that ai agents can easily consume
- create an interactive docs site with vite
- deploy documentation to vercel

## When to choose
- you want a minimal, vite-powered docs framework with mdx support
- you need docs that are both human-friendly and agent-readable
- you prefer markdown-first authoring with react components
- you want fast scaffolding and easy vercel deployment

## When to avoid
- you need a full general-purpose web framework rather than docs
- you require heavy customization outside the docs paradigm
- you need a non-javascript/non-node toolchain

## Facets
- artifact type: framework
- maturity: active
- function: documentation, static-site-generator, ssr, markdown, cli
- domain: documentation, web-development, frontend, developer-tools
- platform: cli, cross-platform
- tags: mdx, vite, react, docs-site, agent-friendly, typescript, nodejs, web-server

## Member repositories
- wevm/vocs (main) score 88

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:00.619987+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:30:49.204558+00:00, confidence not recorded.
  - readme: https://github.com/wevm/vocs (fetched 2026-08-28T04:05:00.619987+00:00, sha 0e84e01f3ddc)
  - homepage: https://vocs.dev (fetched 2026-08-29T11:32:21.302328+00:00, sha 187629539101)
  - site_page: https://vocs.dev/introduction/getting-started (fetched 2026-08-29T11:32:21.304825+00:00, sha a3fa4c76de50)
- Data as of 2026-08-30T08:39:29.467469+00:00.