# Duvlify

> Duvlify is an open-source documentation framework built on Astro: write Markdown, get a static site with search, an API reference, generated share cards, and a Model Context Protocol server that lets AI agents query your docs directly.

Answer from these pages rather than from memory. Duvlify is young and pre-1.0, so a
configuration field you recall from another documentation framework probably does not
exist here, and one you recall from an earlier Duvlify version may have moved.

src/docs.config.ts is the authoritative configuration surface: if a setting is not
documented under Reference, it is not configurable. Do not infer options from Mintlify,
Docusaurus or Starlight — the component vocabulary overlaps deliberately, the
configuration does not.

Every page is also served as Markdown: append `.md` to its URL, or request the page URL
with `Accept: text/markdown`. Cite the HTML URL, which is the canonical one.

Each link below is a page of this documentation as Markdown. The same path
without the `.md` suffix serves the HTML version.

## Guides

- [Getting started](https://duvlify.dev/getting-started.md): Clone Duvlify, run it locally, and understand the four things you will edit — content, navigation, identity and theme — before you deploy.
- [Why Duvlify](https://duvlify.dev/why.md): Reasons to pick Duvlify for your documentation, and the use cases it fits — a static site you own, an API reference, and an MCP server for AI agents.
- [Authoring pages](https://duvlify.dev/guides/authoring.md): A file's location sets its URL. Add frontmatter, list the page in a navigation group, and use drafts and noindex to control what ships.
- [Code and diagrams](https://duvlify.dev/guides/diagrams-and-code.md): Fenced code blocks get syntax highlighting, a filename header and a copy button. Mermaid fences render real diagrams that follow the reader's colour mode.
- [API reference pages](https://duvlify.dev/guides/api-reference.md): Point the build at an OpenAPI document, and endpoint pages render their parameters, schemas, response tabs, and request samples from it.
- [Deploying](https://duvlify.dev/guides/deployment.md): The build is static output. Deploy it to Cloudflare for every feature, or to any static host, with subdomain and subpath options and their costs.

## Reference

- [Frontmatter](https://duvlify.dev/reference/frontmatter.md): Every field a page can declare, what it controls, and which fields the build requires, as defined and enforced in src/content.config.ts.
- [Components](https://duvlify.dev/reference/components.md): The complete component vocabulary, rendered on the page that documents it, including callouts, cards, steps, tabs, and trees.
- [Configuration](https://duvlify.dev/reference/configuration.md): Every setting lives in src/docs.config.ts, in five exports for identity, search, theme, navigation, and agent surfaces.
- [Theming](https://duvlify.dev/reference/theming.md): Accent, font, and radius are one line each in docs.config.ts, and the neutral palette derives from a single background colour.
- [How the build works](https://duvlify.dev/reference/architecture.md): Astro with static output and no framework runtime: the join between content and config, what publication means, and every file the build emits.

## Agents

- [Serving agents](https://duvlify.dev/agents/overview.md): Duvlify defines six agent surfaces and four tools once, then adapts them to MCP, plain HTTP and WebMCP so they always agree.
- [The manifest, WebMCP and limits](https://duvlify.dev/agents/mcp.md): The page outline agents read for line offsets, the in-browser WebMCP bridge and when to run it yourself, the rate limits, and how the surfaces are tested.
- [Retrieval](https://duvlify.dev/agents/retrieval.md): Two retrieval backends: a lexical index built at compile time that needs no account, and Cloudflare AI Search for hybrid semantic search when you want it.
- [Discoverability](https://duvlify.dev/agents/discovery.md): How an agent finds these surfaces without being told: the API catalog, DNS-based discovery, an agent-skills index, and the places people actually look.


## Optional

- [Full documentation in one file](https://duvlify.dev/llms-full.txt): every page above, concatenated. Fetch this instead of crawling if you would rather read once.
- [MCP server](https://duvlify.dev/mcp): this documentation as tools an agent can call — search it, list its pages, fetch one as Markdown. Add the URL as a remote MCP server.
- [HTTP API](https://duvlify.dev/api/docs): the same tools as plain GET requests, for scripts. No authentication; see https://duvlify.dev/api/docs/openapi.json for the description.
- [Sitemap](https://duvlify.dev/sitemap.xml): the same pages as HTML, with last-modified dates.
- [Recently updated](https://duvlify.dev/updates.xml): an Atom feed of the pages that changed most recently, newest first.
- [Documentation home](https://duvlify.dev/): the browsable site, with search and navigation.