Template Variables

Sourced from the active theme's theme.json.

Note on theme.assetsUrl in static builds: During live development, theme.assetsUrl resolves to /app/themes/{id}/assets. The static build engine automatically rewrites this prefix to /assets in every rendered HTML file, so theme authors can use {{ theme.assetsUrl }} freely without any isGenerateStatic conditionals.
The same mechanism applies to theme.path which resolves to /app/themes/{id}: filesystem path to the theme root; useful for advanced template logic or tooling — {{ theme.path/custom/file.ext }}

Object where each key is a menu location name and each value is an array of items. Sourced from app/data/menus.json.

Each item has the shape { id, label, url, children? }. Children support up to 3 levels of nesting.
Every item in a menus object carry its nesting depth field (0 = top-level, 1 = child, 2 = grandchild).

{
    "id": "6fe4e3b5-d2f4-48b2-9b3a-7751c3ec11e3",
    "label": "Getting Started",
    "url": "/getting-started",
    "children": [
        {
            "id": "1dbef501-be21-48f1-aaaa-0d5a2ceeccbc",
            "label": "Project Structure",
            "url": "/getting-started/project-structure"
        }
    ]
}

Use {{#each}} for top-level items, {{#each1}} for depth-2, and {{#each2}} for depth-3:

{{#each menus["primary"]}}
    <a href="{{ url }}" data-depth="{{depth}}">{{ label }}</a>
    {{#if children | length}}
        {{#each1 children}}
            <a href="{{ url }}" data-depth="{{depth}}">{{ label }}</a>
        {{/each1}}
   {{/if}}
{{/each}}

Use this flag to conditionally include dev-only scripts:

{{#if isGenerateStatic}}
<!-- static output: no dev scripts -->
{{#else}}
<script src="/admin/assets/js/live-reload.js"></script>
{{/if}}

One flag is true per render. All others are absent (falsy). Use them to branch logic in shared partials.

Routes: GET /blog, GET /blog/page/:num — Also sets blogRoute = true

Receives shared data, plus:

posts[] — Paginated slice of published posts. Same shape as home's posts but contains only the entries for the current page.

pagination:

Note: when prevPage is 1, link to /blog not /blog/page/1.

Route: GET /blog/:slug — Also sets postRoute = true, contentRoute = true, fileType = "post"

Receives shared data, plus:

post — Full frontmatter plus slug:

relatedPosts — Posts related to the current one:

Posts also support a related_posts field: an ordered array of up to 4 post slugs. Set it from the Related Posts panel in the post editor — a searchable checkbox list of all published posts. The selection order is preserved and exposed to templates as the relatedPosts array, letting theme authors render a "Read Also" or "You Might Also Like" section below the article. Stale slugs pointing to deleted or re-drafted posts are silently dropped at render time.

Order is preserved from the editor (insertion order = author's editorial intent). Max 4 items. Stale slugs (deleted or re-drafted posts) are silently dropped at render time.

prevPost and nextPost — Posts before and after the current one:

These variables provide adjacent-post navigation for the current article. prevPost contains the chronologically older published post, while nextPost contains the chronologically newer published post. Each value is either a post object or null when no adjacent post exists, allowing themes to build "Previous" and "Next" navigation links at the end of an article.

html_content — The post's Markdown body rendered to HTML. Inject unescaped: {{ html_content }}

Routes: GET /:slug (root), GET /:l1/:l2 (depth-2), GET /:l1/:l2/:l3 (depth-3), GET /pages/:slug (fallback) — Also sets pageRoute = true, contentRoute = true, fileType = "page"

Receives shared data, plus:

page — Full frontmatter plus hierarchy fields derived at render time:

html_content — The page's Markdown body rendered to HTML.

Routes: /categories/:category, /tags/:tag (and paginated) — Also sets taxonomyRoute = true

Receives shared data, plus:

Plus the same posts[] and pagination as blog.html.

Triggered: Any unmatched route — Also sets notFoundRoute = true

Note: page, post, posts, and pagination are not available here.

Shared data (site, theme, menus, isGenerateStatic) is still available.