Skip to content

Reference Projects

Choose a maintained, integration-tested Ardo project shape before adapting it to your own repository.

Ardo keeps four small reference projects in the repository. They are maintained as product contracts: each is integration-tested, readable in isolation, and a better starting point for a human or coding agent than a generic generator template.

Product Documentation

The basic reference is for one React app that publishes guides, Markdown/MDX pages, search, and static output.

TypeScript Library Documentation

The library reference pairs guide pages with TypeDoc output from a small TypeScript package.

Monorepo Documentation

The monorepo reference keeps docs and several workspace packages in one repository.

Content Owned Elsewhere

The content sources reference maps Markdown from outside app/routes/ into generated pages and exposes the same static records to a custom React route.

Each reference README declares its intended shape, required files, configurable seams, generated-file boundary, and validation commands. When using an agent, link it to Adopt Ardo in an Existing Project first and ask it to select the closest reference before proposing changes.