Page Types - Loomwork

Loomwork ships with five page templates, each designed for a different kind of content. Set the template field in your frontmatter and the framework handles the rest.

Default

The workhorse. A clean single-column layout with a readable content width. Good for about pages, policy pages, standalone content, and anything that doesn’t need a sidebar.

---
template: "default"
---

Width: --content-width (52rem default). Adjustable via the Reader Controls width picker.
TOC: None (no sidebar). The mobile TOC dropdown still works if there are headings.
Example: About Loomwork

Guide

A two-column layout with a sticky table of contents sidebar on the left and the content on the right. Built for longer pages with many sections that readers need to jump between.

---
template: "guide"
---

Width: Wider container (--content-width + 13rem for the sidebar).
TOC: Sticky sidebar on desktop, collapsible dropdown on mobile. Supports three states via Reader Controls: Full, Numbered (#), Off.
Example: Building Your Site · This page

Landing

A wide-format layout without a sidebar. Designed for marketing pages, homepages, and feature showcases where you need the full width for visual impact.

---
template: "landing"
---

Width: --wide-width (72rem).
TOC: None.
Best for: Hero sections, feature grids, call-to-action blocks.

Tool

A chrome-free utility layout. No page title rendered automatically, no hero — just your content in a wide container. Designed for interactive tools, calculators, dashboards, and widgets.

---
template: "tool"
---

Width: --wide-width (72rem).
Title: Not rendered (you control the markup entirely).
Best for: Embedded apps, config generators, data tools.

Longform ✨

A split-panel layout for deep dives, essays, retrospectives, and serialized content. On desktop, an article index sidebar stays pinned on the left while wide, presentation-style content fills the right. The entire layout is viewport-fitted with internal scroll.

---
template: "longform"
section: "deep-dives"     # groups articles in the sidebar index
nav_order: 10             # controls ordering in the index
---

Desktop: 260px sidebar with numbered article index + wide scrollable content panel.
Mobile: Collapsible article index above the content.
Viewport-fitted: The layout fills 100vh — content scrolls within its container.
Article index: All longform pages sharing the same section value appear in the sidebar automatically, sorted by nav_order.

Example: See the longform demo →

When to use longform

Project retrospectives and post-mortems
Multi-part essays or serialized content
Deep dives on a topic with several related articles
Anything where you want readers to stay in a focused, presentation-like environment

Quick Reference

Template	Sidebar	Width	Auto Title	Best For
`default`	—	52rem	✓	General content
`guide`	TOC	52rem + 13rem	✓	Docs, tutorials
`landing`	—	72rem	✓	Marketing, features
`tool`	—	72rem	✗	Interactive tools
`longform`	Article index	72rem	✓	Essays, deep dives

Setting a Template

Every page’s template is controlled by a single frontmatter field:

---
title: "My Page"
description: "A short description."
template: "guide"        # ← pick your template here
---

If you omit template, it defaults to "default".