Skip to content
BetaDocs

Technical Reference

This section documents the technical contract Typeroll CMS follows when it builds and serves a site in Cloud or a self-hosted installation. It is for developers and operators who need to understand the generated output. See Cloud and self-hosting for differences in service ownership.

Topics covered:

  • Different generators on one website — separate repositories and static deployments sharing a hostname, including docs, indexing and agent text exports.

  • SEO & indexing — canonical URLs, robots, sitemap, structured data, fallback-subdomain de-duplication, and how custom-domain activation affects all of the above.

  • Image optimisation (coming) — how images move from upload through Cloudflare’s CDN into the page, what formats are served, caching behaviour.

  • Social media tags (coming) — OpenGraph + Twitter card defaults, per-page overrides, image sizing.

  • Cache headers & deploy invalidation (coming) — what the _headers file the deploy emits says, how to opt out, when stale assets matter.

  • Site security (coming) — sanitiser behaviour, CSS scrubbing, iframe allow-list, what scripts can and can’t ship.

If something here disagrees with what you observe, the code wins — file an issue or fix it. The pages in this section are written to match the runner / renderer behaviour 1:1, but the implementations are the source of truth.