Documentation

This is the documentation for cairn-cms, rendered on cairn.pub from the same markdown the npm package ships and the GitHub repository carries. If you write for a site built on cairn, Help covers what you need in one page; the rest of this page is for the developer building or maintaining one.

Tutorial Build your first cairn site

Teaches a first build end to end, from an empty directory to a deployed site with a working admin.

Guides Task how-tos

Answer task questions: the GitHub App, auth and D1, the adapter, rendering, deploying, troubleshooting.

Reference The public surface

Documents each package export, one page per subpath, plus the admin route contract and the log event table.

Explanation The why

Covers the architecture, the design rules, and the reasoning behind each. Why cairn lives here too.

When something breaks, start with troubleshooting, which maps symptoms to fixes. The cairn-doctor command checks a site's configuration, and the structured logs record what a running site actually did.