Skip to content

Sites

A folder in sites/ is one Site, its Pages, navigation and Brand, served on its Domains.

A folder in sites/ is one Site: its Pages, navigation and Brand, served on its Domains. It implements the Site product.

  • sites/www/
  • site.mdxDomains, navigation, theme
  • layout.mdxwraps every Page below
  • page.mdx/
  • pricing/page.mdx/pricing
  • blog/[post]/page.mdx/blog/:post
  • not-found.mdxunmatched paths

Reference

A Site is always a folder, even when the Startup has one. site.mdx is frontmatter only.

KeyTypeHolds
domainshostnamesWhere it serves; the first is canonical
navlistNavigation: label and path
themepathA Theme in brand/; the Brand's by default
extendsTemplate idThe site Template it starts from

Examples

Minimal

sites/www/site.mdx
---
domains: [leaseline.com]
---

Leaseline

sites/www/site.mdx
---
domains: [leaseline.com, www.leaseline.com]
nav:
  - { label: Pricing, path: /pricing }
  - { label: Blog, path: /blog }
  - { label: Sign in, path: /app }
---

What it builds

The SiteBuilder compiles the folder and publishes it with Site.publish.

  • a Site, a Page per page.mdx, and one Page per member under a [key] folder
  • a Markdown twin of every Page, and /llms.txt, /agents.json and /sitemap.xml
  • generated /terms and /privacy
  • the Event Site.published

Routing

A folder is a URL segment and page.mdx makes it public. route segments covers groups, keys, private folders and Variants.

Good to know

  • Every Site reads the pricing section from published Offers.
  • The storefront and portal are Pages of the same Site; see storefront.