Prose

The prose layer: one class that typesets long-form content onto the type roles.

Usage

Add typeset to a container. Every heading, paragraph, list, link, code span and table inside binds to a type role with a fixed rhythm, so a docs body, a blog article or rendered markdown is plain elements with no classes.

<article className="typeset">
  <h1>Title</h1>
  <p>Body copy on Copy 16, headings on the article scale.</p>
</article>

Every rule is scoped with :where(), so a utility on the element still wins, and a subtree marked not-typeset opts out entirely. Rhythm is set by two custom properties, --typeset-flow between blocks and --typeset-section above a section heading. Everything below this line is one typeset body, written as bare elements.


Heading 1 binds to Heading 40

The first heading level inside a body is the page-title role. This paragraph is Copy 16 on Color 9. Every block sits 24px below the one before it, headings included.

A second paragraph keeps the flow gap. Inline semantics bind too: strong is the Copy role's Strong modifier, emphasis stays italic, code becomes a chip, ⌘ K is a key cap, mark highlights, and abbreviations carry a dotted underline. A link is underlined on the text color, never on the accent.

Heading 2 binds to Heading 32

Section headings take the section gap above, 72px by default. The role is applied as is: no weight, size or leading is overridden, so a heading here is identical to the same role anywhere in the app. A code span inside a heading keeps its Copy 13 Mono role too.

Heading 3 binds to Heading 24

Subsections take 64px above.

Heading 4 binds to Heading 20

Minor headings take 48px above.

Heading 5 binds to Heading 16, Heading 6 to 14

The smallest steps, 32px above, for run-in labels inside a subsection.

Lists

Unordered lists use a disc, then a circle when nested.

  • The marker sits on Color 6, a step lighter than the body.

  • Items are 8px apart with 8px of padding after the marker, and a nested list keeps that gap.

    • Nested items use a circle.
    • They indent by the same 20px as the parent.
  • A block inside an item takes the item gap, whether it follows text or not.

    Like this paragraph.

Ordered lists use decimals.

  1. Read the roadmap.
  2. Cut the seam.
  3. Ship the layer.

Definition lists set the term on Color 10 and indent the detail.

Role
A named combination of size, leading, tracking and weight.
Ramp
The ten-step scale every color in the system is drawn from.

Quotes, rules and disclosures

A blockquote is a pull quote: the text sits on Heading 24 with hanging quote marks drawn by the layer, and a trailing footer carries the attribution, with cite for the name. It takes half the section gap above and below.

Minting short-lived tokens instead of keeping provider credentials in paused sandboxes has removed a whole class of security risk for us.

Fraser Brown BuildPass

Disclosures take the Accordion component's shape on the body role, with no hairline between rows. Adjacent ones stack; each opens on its own, since markdown cannot group them.

Is this a native details element?

Yes. The summary is the trigger with the chevron at the end, and this content sits flush beneath it with 16px below, the same as the accordion panel.

A second paragraph keeps the panel's 16px gap.

What does it not do?

It does not animate open and closed, and it does not close its siblings when opened. Both need the component.

Where does the look come from?

The Accordion component is the source of truth; the prose layer mirrors it by hand.


A horizontal rule is a 1px line on Color 2 with 80px above, 160px on wide screens, marking a break larger than any section.

Code

Inline code is the Copy 13 Mono chip on Color 1. Code blocks are Copy 13 Mono on Background 2 with a hairline and 16px of padding. Syntax color is a pipeline concern and lands on the tokens inside; the surface is the same everywhere.

@import "@nafisazizir/ziiz/theme.css";

.article {
  --typeset-flow: 1rem;
  --typeset-section: 4rem;
}

Tables

Tables match the table component: Heading 14 header cells, Label 14 body cells with tabular numerals, and a hover on each row. The separator sits on the cell, so appending a row never needs a rule to change.

ElementRoleGap above
h1Heading 4072px
h2Heading 3272px
h3Heading 2464px
h4Heading 2048px
p, ul, ol, dlCopy 1624px
pre, tableinherits28px
blockquoteHeading 2436px
figureinherits40px

Figures

image or embed
A figure takes 40px above and below; its caption is Copy 14 on Color 9, centered, 16px below.

Opting out

A component with its own chrome sits inside a body by marking its root not-typeset. Nothing inside it inherits paragraph margins, link underlines or code chips. The alert below is stock; the button next to it is a plain component in a plain paragraph and needs no marker because no rule targets it.

Density

The two rhythm properties are the only knobs. The block below sets --typeset-flow to 12px and --typeset-section to 32px on a nested container, and everything inside tightens.

A denser body

Paragraphs sit 12px apart instead of 24px.

Section headings pull in from 72px to 32px, subsections to 28px.

Another section

  • Lists keep their own 8px item gap.
  • Only the two properties changed.

Go to a page

Search every page in the navigation.