Site header

Quail Pages Documentation

Build websites with Quail Pages

Quail Pages is an authored JSON website system for creating fast, static websites from a small, structured content model.

This documentation is itself a Quail Pages website. The Document pages are generated from the same JSON Schema that defines the Quail Pages authored contract.

  • Author sites with structured JSON
  • Reuse content with components
  • Extend sites with plugins
  • Render everything to static HTML
Explore the Documentation
Explore the Style Guide
Explore Theme
Browse Icons

Machine-readable contracts

Architecture

qp.architecture.json Defines how Quail Pages concepts are organized, names canonical responsive presentation-width ranges, and records keyless stylesheet infrastructure such as base.css.

Authoring Schema

qp.schema.json Defines what can be authored in Quail Pages, including document structures, elements, properties, constraints, and composition rules.

Site Discovery Knowledge Contract

qp.site-discovery.json Defines optional, provenance-aware knowledge gathered before creative direction; discovery seeks sufficiency rather than completeness.

Site Discovery Interview Contract

qp.site-discovery-interview.json Defines declarative guidance for asking only questions whose answers can materially change subsequent work.

Class Contract

qp.classes.json Defines the stable classes, structural relationships, modifiers, states, and styling hooks emitted or managed by Quail Pages.

Base Theme Inventory

qp.theme.json Inventories every CSS custom property defined by QP Base, including ownership, references, fallbacks, scoped definitions, consumers, and source files.

FeatherQuest Effective Theme

featherquest.theme.json Resolves Base architecture with FeatherQuest’s declared variable overrides, remaps, and theme-owned decisions.

Theme Extension Schema

qp.theme-extension.schema.json Defines the sparse declaration format for theme overrides, semantic remaps, and theme-owned variable architecture.

Markup Effective Theme

qp-markup.theme.json Resolves Base architecture with Markup’s declared variable overrides, remaps, and theme-owned decisions.

Icon Registry

icons.json Defines canonical icon names, human descriptions, discovery keywords, and renderer-owned SVG path geometry.