Recipes
- Monorepo with external docs
One site for a multi-package repo - each package's docs folder mounted under its own route, examples mirrored, the site as an npm workspace member, CI from the root.
- Separate site repo
Keep the website in its own repository and read the library's docs from it with a git source, or its docs and demos from a second checkout, locally and in CI with source-repo.
- Search and analytics
Pagefind search out of the box, swapping in another search through Starlight, and adding an analytics script to every page.
- Languages
A site in one language other than English, right-to-left languages, changing the template's words, and what multilingual sites can expect.
- Accessibility
What the template does for keyboard, screen-reader and low-vision readers, and how each change is checked.
- Troubleshooting
Link validator failures, mirror collisions, edit links without git, a page missing from the sidebar, option errors and deploy problems.