BxSites Getting Started

BxSites (ortus-boxlang/bx-sites) is an AI-first static site generator in the spirit of mkdocs/GitBook: point it at a docs/ (or src/) folder of Markdown and it builds a themed, searchable static site - docs, blogs, marketing sites or knowledge bases. Every build is AI-ready (llms.txt, an optional MCP manifest), and a site can be hosted anywhere or published to bxSites Cloud. It runs on BoxLang.

Every command runs as bxSites <verb> [options] (or boxlang bxSites <verb> [options] where the PATH shim isn't installed - e.g. a CI runner). Every verb accepts --projectRoot=<path> or a bare positional path as the project root (bxSites build ../my-docs), so a verb's own primary argument always uses --flag=value, never a bare positional value - it would be read as the project root. Exceptions: new my-docs takes the target directory as a bare path; serve also takes --port 9191 --host 127.0.0.1 space-separated; and any colon verb also works as two words (bxSites page new --path=...).