Create or replace pages, each sent whole, and delete others; optionally rename the site, change its theme, or set its header, replaced whole. A page you do not send is left as it is. Every write can be undone (history, undo). The input schema gives every block's fields.

Pages

• path "" is the home page and must exist. Other paths are lowercase slugs, slash-separated, no leading slash.

• navOrder places a page in the header nav (0 first); null keeps it out. The home page is reached by the site name, so give it null.

• path "_footer" is not a page to visit but the footer shown under every page: addresses, hours, contact details. Content and columns blocks, no hero and no h1, navOrder null. A site without one has no footer.

• description is the page's search snippet: one sentence, under 160 characters.

• Omit every id.

Blocks

• A page is a list of blocks, stacked vertically. Every page has exactly one h1: a hero's heading, a product's or a products block's with a menu, or else an h1 at the top of its first content block.

• "hero" opens a page: a heading (the h1), a sentence or two of plain text, and optionally one button. Its heading and text, and a cta's, are plain text that may wrap words in or , as the source sets them bold or italic. Use it on the home page and on pages that sell something. Its optional image is a picture filling the opening behind the words, by https URL, under the same rule as an image block. Where its words are a subheading rather than a sentence (a line or two, often set as headings at the source), give "subheading": true. With no picture, "backdrop": "mesh" or "grain" sets a slowly moving field of the site's own colours behind the words, smooth or grainy: at most one on a site, on the home page's opening, for a brief that wants a modern or striking look, and never on a site moved across from elsewhere.

• "content" holds HTML, plain and semantic: h1–h4, p, ul, ol, li, a, strong, em, blockquote, table, hr. No class, style, script or img: they are stripped. After a hero, headings start at h2.

• "columns" sets 2–4 columns side by side, each {"blocks": [...]} of content, image and video blocks: for features, services or contact details. They stack on a phone. To place them freely instead, as a page builder's grid does, give every column an "area": {"col", "span", "row", "rows"} on twelve columns, rows counted from 1 (up to 12 columns then); cells may sit lower than their neighbours or overlap.

• "image" shows a picture by https URL, with alt text that says what it shows. Use only image URLs the brief gives you; never invent one.

• "video" plays a video file: {"src": https URL of an MP4, "poster"?: the picture it shows before it plays}. It goes wherever an image can, columns included. Use only video files the brief gives; a YouTube link is an iframe in a content block.

• "carousel" sets several pictures in one row the visitor scrolls sideways: {"blocks": [image blocks]}. Use it wherever pictures would otherwise follow one another, and for any gallery or slideshow on a site being moved across: one carousel holding each picture once, in order, without the slideshow's counters ("Image 1 of 12") or its thumbnails.

• "infobox" is a facts panel beside the text, holding content and image blocks; a two-column table of facts is its usual content. Use it on a page about one thing (a product, a place, an organisation), placed before that page's content.

• "cta" asks for one action: a heading, a sentence, and a button. At most one per page, usually last.

• "product" makes its page one thing for sale: {"images": [https URLs, the first on every listing], "price"?: as it reads ("£2,500"), "sold"?: true, "tags": [the lists it appears in], "text": HTML of what it is (materials, size, year, words about it)}. It draws the page's title as the h1, so the page has no hero; it goes first. One product per page. Write a price as an amount, "£2,500", "$40" or "€12.50", and the product can be bought online once the site takes payment; "from £40" or "POA" keeps it to the Enquire button. Where it is sold elsewhere, as a book is by its publisher, give it "action": {"label": "Buy from Salmon Poetry", "href": the page that sells it}.

• "products" lists the site's product pages as cards of their pictures, name and price, newest first: {"tag"?: "Painting"} for those with that tag, none for all. A shop with several lists gives each list's block a "menu" of links to all of them, [{"label": "All", "href": "/shop"}, …], shown down the left; the block then heads the page with its title, so the page needs no other h1. Its cards crop each picture square; "shape": "portrait" sets them upright, for books and posters, and "landscape" wide. The cards are drawn from each product's page, so never copy a product's pictures, name or price onto another page; list it with a "products" block instead.

• "donate" takes gifts for a charity or a cause: {"amounts": the suggested gifts in one currency, as they read (["£10", "£20"]), "monthly"?: true where donors may give every month as well as once}. The donor may always give an amount of their own. It shows once the site takes payment. Use it only where the brief asks for donations, with the words that ask for them before it.

• "stats" sets 1–6 figures in a row, each {"value": as it reads ("1987", "40+"), "label": what it counts}: years open, customers served, awards. Only figures the brief gives.

• "testimonial" is one person's words about the business: {"text": their words exactly, "name", "role"?, "image"?: their photo by https URL}. Only quotes the brief gives, never one written for them.

• "poem" sets one poem, or a song's words, line for line as written: {"title"?, "text": plain text, a line to a line, a blank line between stanzas, the spaces that indent a line kept, and words set in italic or bold wrapped in or , "note"?: one line under it, such as where it first appeared}. Verse goes in a poem block, never a content block, whose paragraphs would run its lines together. Copy every word, line break and indent exactly, and only poems you were given.

• "pages" shows cards (picture, title, snippet) for the pages directly under a path, {"under": "works"}, or for the site's newest pages, {"newest": 6}: a section's index page, or a blog's latest posts.

• "code" shows code to copy in tabs, {"tabs": [{"label": "JavaScript", "code": "…"}]}: for a developer or a product with an API.

• "contents" lists links to the page's own sections, its h2s. Use it at the top of a long page with several sections.

• "comments" lets visitors comment on the page, each comment shown once an owner approves it. Use it only where the brief asks for comments, usually at the foot of a blog post.

• "contact" is a form for a visitor's name, email address and message, which reaches the site's owners privately and never shows on the site. Use it on a contact page, and wherever the brief asks to be written to but gives no address to publish.

• "search" is a box that searches the site's pages. Use it on a site of many pages, on the home page or a page of its own.

• Any block of the page's own (not one inside columns or a facts panel) may take "band": "panel" or "accent", which sets it on a strip of that colour from edge to edge. Use bands sparingly, to set a section apart; consecutive blocks with the same band read as one section.

• A button's href is a page on the site ("/contact"), an https URL, a mailto: or a tel: address. Link between pages with root-relative hrefs, never the full domain.

• Write every phone number as a tel: link and every email address as a mailto: link, so a visitor on a phone can tap it.

Theme

• Each value is a CSS colour, OKLCH preferred, e.g. "oklch(0.72 0.16 40)". Choose what suits the business, and keep text readable on bg (contrast 4.5:1 or better) and muted text still legible.

• --font-sans is one of these values, written exactly: Clean: "ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif"; Friendly: "ui-rounded, SF Pro Rounded, Nunito, Varela Round, system-ui, sans-serif"; Humanist: "Optima, Candara, Seravek, Gill Sans Nova, Noto Sans, sans-serif"; Classic: "Charter, Bitstream Charter, Sitka Text, Cambria, Georgia, serif"; Elegant: "Iowan Old Style, Palatino Linotype, Palatino, URW Palladio L, serif"; Typewriter: "ui-monospace, SF Mono, Menlo, Consolas, monospace"; Inter: "var(--font-inter), ui-sans-serif, system-ui, sans-serif"; DM Sans: "var(--font-dm-sans), ui-sans-serif, system-ui, sans-serif"; Manrope: "var(--font-manrope), ui-sans-serif, system-ui, sans-serif"; Nunito: "var(--font-nunito), ui-rounded, system-ui, sans-serif"; Work Sans: "var(--font-work-sans), ui-sans-serif, system-ui, sans-serif"; Space Grotesk: "var(--font-space-grotesk), ui-sans-serif, system-ui, sans-serif"; Bricolage Grotesque: "var(--font-bricolage), ui-sans-serif, system-ui, sans-serif"; Lora: "var(--font-lora), Georgia, serif"; Playfair Display: "var(--font-playfair), Georgia, serif"; Source Serif: "var(--font-source-serif), Georgia, serif"; Crimson Pro: "var(--font-crimson), Georgia, serif"; Bitter: "var(--font-bitter), Rockwell, Georgia, serif"; Young Serif: "var(--font-young-serif), Georgia, serif"; JetBrains Mono: "var(--font-jetbrains), ui-monospace, monospace". The first six use fonts every device has; the rest are web fonts miow serves. Nothing else loads, and a value with quotes is discarded.

• roundness, density, scale and depth are numbers from 0 to 1 that shape every page: corners from square to round, spacing from roomy to compact, headings from close to body size to far larger, and shadow from flat to raised. Choose them for the business as you choose its colours; 0.33, 0.5, 0.5 and 0 is a plain, even look.

• --hero-entrance makes an opening's words arrive as the page opens: "rise", "focus" or "unveil". Leave it unset unless the business suits motion.

• Looks to start from, each its colours in words and the rest of its theme. Where one suits the business, take its theme whole and choose colours that match its words, in the business's own hue:

  • Quiet luxury: ivory and warm near-black, one muted accent, a high-contrast serif and room to breathe; for premium goods, fashion and private services. {"roundness":0.05,"density":0.1,"scale":0.75,"depth":0,"--font-sans":"var(--font-inter), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-playfair), Georgia, serif","--font-heading-weight":"400","--hero-entrance":"focus"}

  • Japanese minimal: rice paper and soft ink, one seal-red accent, a calligraphic serif and wide empty space; for studios, tea, food and wellness. {"roundness":0,"density":0,"scale":0.6,"depth":0,"--font-sans":"ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif","--font-heading":"var(--font-crimson), Georgia, serif","--font-heading-weight":"400","--hero-entrance":"rise"}

  • Editorial: warm paper and ink-black, one vermilion accent, a large serif over a clean sans, square corners; for writers, magazines and studios. {"roundness":0,"density":0.35,"scale":0.9,"depth":0,"--font-sans":"var(--font-work-sans), ui-sans-serif, system-ui, sans-serif","--font-heading":"Charter, Bitstream Charter, Sitka Text, Cambria, Georgia, serif","--font-heading-weight":"400"}

  • Corporate: white, blue-grey ink and one deep accent, one sans throughout, modest headings; for firms, finance and anything that must look dependable. {"roundness":0.33,"density":0.55,"scale":0.25,"depth":0.1,"--font-sans":"var(--font-inter), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-sans)","--font-heading-weight":"700"}

  • Dark tech: near-black with fine lines and one bright accent, a geometric sans; for software, developer tools and technical products. {"roundness":0.33,"density":0.6,"scale":0.45,"depth":0,"--font-sans":"var(--font-inter), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-space-grotesk), ui-sans-serif, system-ui, sans-serif","--font-heading-weight":"700","--hero-entrance":"rise"}

  • Playful: cream with saturated colour and black ink, round corners and a chunky sans; for shops, children, food and events. {"roundness":0.66,"density":0.45,"scale":0.8,"depth":0,"--font-sans":"var(--font-nunito), ui-rounded, system-ui, sans-serif","--font-heading":"var(--font-bricolage), ui-sans-serif, system-ui, sans-serif","--font-heading-weight":"700","--hero-entrance":"rise"}

  • Industrial: aged paper and black, one signal colour such as safety orange, square edges and a heavy grotesk at great size; for makers, workshops and engineering. {"roundness":0,"density":0.65,"scale":1,"depth":0,"--font-sans":"var(--font-work-sans), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-space-grotesk), ui-sans-serif, system-ui, sans-serif","--font-heading-weight":"700","--hero-entrance":"unveil"}

  • Retro print: warm print stock, print-black and one riso ink such as red, a bold slab over a quiet serif; for bookshops, records, posters and local makers. {"roundness":0,"density":0.4,"scale":1,"depth":0,"--font-sans":"var(--font-source-serif), Georgia, serif","--font-heading":"var(--font-bitter), Rockwell, Georgia, serif","--font-heading-weight":"700"}

  • Cinematic: warm studio paper and black, one electric accent, a tight sans at very large sizes and an opening that unveils; for launches, film and agencies. {"roundness":0.1,"density":0.3,"scale":1,"depth":0,"--font-sans":"var(--font-inter), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-sans)","--font-heading-weight":"700","--hero-entrance":"unveil"}

Copy

• Most visitors read on a phone. Short paragraphs, plain words, the important thing first.

• Write in the business's own voice, from what you were given.

• Every claim must come from what you were given: the brief, the owner's own words, or their current site. That covers the obvious (prices, addresses, phone numbers, opening hours, testimonials, staff) and the easy to slip in: named products, how things are made ("by hand", "local ingredients"), delivery terms, service areas, and the business's name. Where you were given no name, use the plainest description of the business.

• A thin brief makes a short site. One honest page beats four padded ones; never fill a page to make it look complete.

Images: upload_image first, then use the URL it returns.