Pages

A page is a renderable canvas inside a Typograph document. Pages carry geometry (size, margins, bleed), layout aids (guides, grid, ruler guides), visual properties (fill, stroke, gradient), and the actual page elements that make up the design. See Elements for element-level detail.

Page Types

A type field distinguishes page layouts:

Type	Description
single	A single page
spread_horizontal	A horizontally arranged spread (typical for books, magazines)
spread_vertical	A vertically arranged spread

Spread pages also set spreadPages (> 1) to indicate how many logical pages make up the spread.

Geometry

Property	Description
width, height	Page dimensions in native units
bleed	Print bleed extending beyond the trim edge
leftMargin, topMargin, rightMargin, bottomMargin	Content safe-area margins (stored as four independent fields, not a combined shorthand)
nativeSize	Authoritative size object used for export
screenSize	Optional editor-only size, reflecting current zoom

Identity

Property	Description
id	Numeric id, unique within the document
uuid	UUID, stable across edits
name	Internal name
pageName	User-visible name shown in the editor
pageActive	Whether this page is part of the active export range

Fill, Stroke & Gradient

Pages reference swatches the same way elements do (see Styles):

• fillSwatchUuid, fillTintValue — solid fill
• strokeSwatchUuid, strokeTintValue — border stroke
• gradient (optional) plus nativeGradientFillStart, nativeGradientFillLength, gradientFillAngle — gradient fill
• Corresponding ...Stroke... fields for a gradient stroke

Layout Aids

Purely editorial — they don't render on output but help during editing:

• guides — user-drawn alignment lines
• grid — configured grid overlays
• rulerGuides — guides pinned to the rulers
• locked, showTemp — editor flags for locking and temporary element visibility

Page Elements

The actual content lives in the pageElements array — a list of text blocks, images, shapes, tables, groups, etc. See Elements for the element model.