Skip to main content

Documentation

The documentation repository holds both Axxya documentation sites, built with Docusaurus. The public/ site is the public Nutritionist Pro docs at nutritionistpro.com/docs, and the runbooks site is this internal dev docs site. Both sites publish each page as HTML and as raw Markdown, plus an llms.txt index, so the docs are usable by people and by AI tools.

Repository​

Both sites have a search box in the navbar, provided by the @easyops-cn/docusaurus-search-local theme. The index is generated during docusaurus build, which is the Cloudflare Pages build command, so every push to main re-indexes the site with no extra step. The dev server (npm start) has no search; to try it locally, run npm run build && npm run serve in the site folder.

Each site indexes only its own pages. The public site's build never reads runbooks/docs, so runbook content cannot appear in the public search. As a guard, the public build also runs scripts/check-search-isolation.mjs, which fails the build if the index contains a runbook-only term, a URL outside /docs/, or a draft route. To run the check on its own after a build:

cd public
npm run check:search-isolation

If a draft section is released, remove its route from the draftRoutes list in that script in the same change.