ShellDocs.CLI

ShellDocs.CLI is the global .NET tool that scaffolds, runs, and publishes ShellDocs sites. Install once, use from any directory.

You install this globally, not per-project

Unlike the RCL packages, the CLI is a dotnet tool install -g global tool. Every ShellDocs project on your machine uses the same installed CLI.

Install

bash

dotnet tool install -g ShellDocs.CLI --prerelease

The --prerelease flag is required while ShellDocs is on 0.x.y-alpha versions. Update the CLI with:

bash

dotnet tool update -g ShellDocs.CLI --prerelease

The four commands

Prop	Type	Default	Description
`init`	`command`	—	Scaffold a fresh ShellDocs site OR augment an existing Blazor project. Two modes: create (default) and attach (--attach).
`add`	`command`	—	Scaffold a starter .md page from a template (component / guide / page) into content/.
`dev`	`command`	—	Start the dev server with hot-reload on .md / .razor / .cs changes.
`build`	`command`	—	Export a static site: prerenders every page, writes redirects, optional sitemap and social meta tags.

`shelldocs init`

Two modes. Create (default) scaffolds a fresh Blazor Web App under docs/<Name>.Docs/, patches Program.cs + App.razor, drops starter content : one command from empty dir to running site.

bash

shelldocs init MyDocs             # create docs/MyDocs.Docs/
shelldocs init MyDocs --yes       # non-interactive, no prompts

Attach mode (--attach) augments an existing Blazor project in place. Never touches your Program.cs : instead emits SHELLDOCS_SETUP.md with copy-paste snippets so you can wire it into your custom middleware / auth / etc. yourself.

bash

shelldocs init --attach --dir path/to/my/blazor/project

Both modes idempotent : running twice is a no-op.

`shelldocs add`

Scaffolds a starter markdown page from a template.

bash

shelldocs add component Button         # → content/docs/components/button.md
shelldocs add guide getting-started    # → content/docs/guides/getting-started.md
shelldocs add page faq                 # → content/docs/faq.md

Prop	Type	Default	Description
`component {Name}`	`template`	—	Frontmatter + intro + razor:preview block + TypeTable props skeleton + Notes section.
`guide {slug}`	`template`	—	Frontmatter + intro + Steps skeleton + Next section.
`page {slug}`	`template`	—	Blank frontmatter + H1.

Slugifies PascalCase inputs (MyBigCard → my-big-card.md) and TitleCases kebab inputs (getting-started → "Getting Started"). Refuses to overwrite unless --force.

`shelldocs dev`

bash

shelldocs dev              # port 5000
shelldocs dev --port 5100  # custom port

Wraps dotnet watch run with markdown-file watching. Any .md, .razor, or .cs edit hot-reloads the browser.

`shelldocs build`

bash

shelldocs build --output publish
shelldocs build --site-url https://docs.example.com        # sitemap, robots, social meta
shelldocs build --output publish --base-href "/my-repo/"   # for GH Pages subpath

Publishes the project, starts it locally, saves every page as static HTML, writes redirect pages, a 404.html, the search index and the llms.txt files, and copies the assets. --site-url adds a sitemap, a robots file and social meta tags; --base-href handles subpath hosting; --spa-fallback replaces 404.html with the home page. See shelldocs build.

Version discipline

shelldocs init scaffolds package references at the CLI's own version, read from its assembly. A project scaffolded with CLI 0.1.17-alpha references the 0.1.17-alpha packages. In CI, pin the tool to the same version your project references.

Learn more

Quick start

From zero to a live docs site in five minutes.

Project structure

What shelldocs init created, folder by folder.