Deploying docs to docs.monkeytest.ai
The documentation site is a static VitePress build.
docs/.vitepress/distWhere it is hosted
Production is Vercel. Checked 23 Oct 2026:
https://docs.monkeytest.airesponds withserver: Vercel.- DNS for
docs.monkeytest.aiis a CNAME tovercel-dns. .github/workflows/docs.ymlbuilds the site and uploads adocs-siteartifact. It does not deploy. The Vercel project is connected to the GitHub repo on its own.
VitePress is configured with cleanUrls: true, so every internal link is extensionless (/getting-started/quick-start). The build still emits getting-started/quick-start.html. Vercel does not map that clean path to the file unless cleanUrls is enabled. Moved pages, including /guide/quick-start, redirect in vercel.json. That flag lives in vercel.json at the repository root (Vercel has no dashboard toggle for it). netlify.toml and docs/public/_redirects are not read by Vercel — _redirects is published as a static file and returns 200, which is why those rewrites never fixed the 404s.
vercel.json in this repo sets:
cleanUrls: true—/guide/quick-startservesquick-start.html, and a request for the.htmlURL redirects to the clean path.trailingSlash: false—/guide/quick-start/redirects to/guide/quick-start, which is what the VitePress client expects.
What has to be true in the Vercel project
vercel.json is only applied when it sits in the project's Root Directory.
- Root Directory: repository root (the directory that contains
vercel.jsonandpackage.json). - Build command:
npm run docs:build(install isnpm ci/npm install). - Output directory:
docs/.vitepress/dist. - Node: 20 or newer.
This repo does not override the build command inside vercel.json, so those three settings stay in the Vercel dashboard. If a deploy still 404s on /guide/quick-start after vercel.json is on main, the Root Directory is probably not the repo root — move vercel.json to that directory, or set Root Directory back to the repo root, and redeploy.
What the VitePress build emits
These are repository outputs. They do not require a dashboard change, and this tree does not deploy them.
docs/public/robots.txtis copied to the site root.sitemap.xmlis generated becausedocs/.vitepress/config.mtssetssitemap.hostnametohttps://docs.monkeytest.ai.- Each HTML page gets
<link rel="canonical">fromdocsCanonical(). Clean URLs, no trailing slash except/.
Until a later production deploy, https://docs.monkeytest.ai/robots.txt and https://docs.monkeytest.ai/sitemap.xml can still 404. Do not treat that 404 as a reason to edit the Vercel project. Root Directory, build command, and output directory stay the dashboard settings described above.
Build locally
npm ci
npm run docs:build
npm run docs:previewThe preview server understands clean URLs. A plain static file server will not, until the host rewrites .html the way Vercel does with cleanUrls.
Other hosts
The same output can be uploaded to Netlify, Cloudflare Pages, or GitHub Pages. Netlify and Cloudflare need the rewrite rules in netlify.toml and docs/public/_redirects (splat rewrites to .html). GitHub Pages does not apply either file; use the VitePress GitHub Pages guide if you ever move the site there.
Do not enable HTML minification on the host. VitePress relies on HTML comments, and stripping them causes hydration mismatches.