miow

Make a new, empty site, live at once at https://<slug>.miow.me. Returns its token (pass it to every other tool as `token`) and a claim link. Give the claim link to your human: opening it on their phone saves a passkey that makes them the owner. An unclaimed site is deleted after 30 days; its free 14 days start when it is claimed. Then fill the site with write_site.

Delete a wiki page and its whole history. This cannot be undone, and restore_wiki_page cannot bring it back: read it first with read_wiki_page if it may be wanted. A category's hub article is its category's path.

Where the domain from set_domain stands, checked again now: `kind` is pending, with the DNS `records` still missing, live once it serves the site, or none if no domain is asked for. DNS can take an hour to be seen; call again later rather than in a loop.

A site's name, theme, header, address and every page by path and title, plus its status: a running or failed job (from import_site), its `domain` (none, pending on DNS, or live), `hosting` (unclaimed, trial, paying, unpaid, paused, or free, never billed) and `payments` (ready: Buy, the cart and donations show; none or pending: its owner has not connected Stripe, or Stripe is still checking the account, so they are hidden; off: miow takes none here). Call before changing a site you did not just create; write_site replaces the header whole, so change it from this one. With `site` and no token, any live site's name, address and pages as it lists them, a wiki's being its articles outside hidden categories, without its status.

The site's visitors, engaged visitors (who kept a page open fifteen seconds or clicked, scrolled or typed on it), agents, page views and bounce rate (one-page visits never engaged with) over the last `days` days, the same figures for the same number of days before, visitors and agents by day, the agents by name, its most visited pages, entry pages, sources (a referring host or a link's utm_source), countries (ISO codes) and devices, and what visitors searched the site for and found nothing. A visitor is one browser on one day, counted without cookies. An agent (an AI crawler, an MCP client, or anything reading the site's markdown, llms.txt or .well-known files) is counted the same way and never among the visitors.

The last 30 changes to the site, newest first: what each did, who made it and when. Pass a change id to undo to put the site back as it was before that change.

Replace the site's pages with an existing website's (Squarespace, Wix or anything else: its sitemap, or failing that its home page's links, says which pages), word for word, at the same paths, with its images copied across. Runs in the background for a minute or two: poll get_site until `job` is null, or read its error.

Add one block to a page, after or before a block named by its id (in a column, when that block is in one), or at the end. Returns the new block's id. The input schema gives every block's fields, and write_site's description says what each is for. Images: upload_image first.

A link that makes whoever opens it the owner of a site nobody owns yet, after saving a passkey. Works once, for two weeks. Give it to the person who should own the site, never post it. Once the site has an owner, they invite others from its settings.

Move one block on a page, as it is, to after or before another block named by its id (into a column, when that block is in one), or to the end of the page. Nothing else on the page changes.

One page whole, in the shape write_site takes, so you can change it and send it back. Read every page you mean to change first: write_site replaces a page whole. With `site` and no token, the page as its address shows it: on a wiki, the article there; a sold product without its price.

One wiki page whole: its title, blocks, metadata, version and how many revisions it has. Pass its version as base_version when you save it back.

Take one block off a page, by its id from read_page; in a column, it leaves the column. Every other block stays as it is, and history and undo put it back.

Put a wiki page back as one of its revisions had it. The restore is a revision of its own, so it can be undone the same way.

Create a wiki page, or change one, as one revision of its history. Send the blocks whole, with base_version from read_wiki_page: a save over a page someone changed since is refused, and you read it again. A change to blocks or title moves its version (major for added, moved or removed blocks, minor for changed words); a metadata-only change moves nothing. 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 "search" is the site's search results page, which every site has, with a search box on every page; no page takes it. - path "_footer" is not a page to visit but the footer shown under every page: addresses, hours, contact details. Content, locations 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 the id of a block you add, and keep every id a page was read with, so a wiki page's history matches its blocks one for one. Blocks - A page is a list of blocks, stacked vertically. Every page has exactly one h1: an opening hero's heading, a product's or a products list's with a menu, or else an h1 at the top of its first content block. - "hero" is a heading, a sentence or two of plain text, and optionally one button. It opens a page, its heading the h1: use one on the home page and on pages that sell something. With "call": true it is a call to action further down instead: at most one on a page, usually last, asking for one action, with a button. Its image is under the same rule as a pictures block. Give "subheading": true where its words are a subheading rather than a sentence (a line or two, often set as headings at the source). A "backdrop" at most once 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. An opening with nothing behind it always fits its words, so give it no height. - "content" holds HTML, plain and semantic: h1–h4, p, ul, ol, li, a, strong, em, blockquote, table, hr. No class, style or script: they are stripped. No img either: a picture goes in a pictures block. An iframe embeds a YouTube video, a Google or Apple map, or a Zeffy donation or ticket form, its src the form's own zeffy.com address. After a hero, headings start at h2. - "columns" sets 2–4 columns side by side, 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" (up to 12 columns then); cells may sit lower than their neighbours or overlap. With "beside": true and one column, it is a facts panel beside the text instead: on a page about one thing (a product, a place, an organisation), its usual content a picture and a two-column table of facts. - "pictures" shows pictures, or video files that play: one is a figure, several a row the visitor scrolls sideways, or with "grid": true a gallery to look over rather than step through. Use only picture and video URLs the brief gives you; never invent one. For any gallery or slideshow on a site being moved across, one pictures block holding each picture once, in order, without the slideshow's counters ("Image 1 of 12") or its thumbnails. A YouTube link is an iframe in a content block. - "product" makes its page one thing for sale. 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. A service is a product with "service": true; its button reads Book. A thing a buyer downloads once they have paid (an ebook, a pattern, a track) carries "file": keep it as read, never write one. - "list" lists pages of the site, read as the page is: "under" a section's index page, "newest" a blog's latest posts, "chosen" those named, in order, or "products" the product and service pages, newest first. A shop with several lists gives each list's products block a "menu" of links to all of them, [{"label": "All", "href": "/shop"}, …]; the block then heads the page with its title, so the page needs no other h1. A list is drawn from each page, so never copy a product's pictures, name or price onto another page; list it. - "donate" takes gifts for a charity or a cause, and shows once the site takes payment. Use it only where the brief asks for donations, with the words that ask for them before it, and "amounts" and "monthly" only where the brief gives them. - "stats" sets figures in a row, each "label" saying what its "value" counts: years open, customers served, awards. Only figures the brief gives. - "testimonial" is one person's words about the business. Only quotes the brief gives, never one written for them. - "poem" sets one poem, or a song's words, line for line as written. 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. - "events" lists exhibitions, shows, talks or performances. Give every event in one block, in any order: an event moves under the other heading on its own once it ends. Never split a list into upcoming and past by hand, and never write its dates into the text as well. Its headings are h2s, so a page about events opens on an h1 before it. - "locations" sets out where a business is and when it is open. Its image is under the same rule as a pictures block. The page groups the days ("Mon–Fri 8am–6pm") and says whether each is open now, by its own clock, so never write hours, an address or its phone number into a content block as well. Every shop, studio or office's address and hours go in one, on its contact or visit page and in the footer; a page about several gives every one in one block. Only hours given as regular opening hours: visits by appointment, or a reading on the third Tuesday of the month, are words in a note or a content block. Its names are h2s, or h3s under its heading. - "codeTabs" shows code to copy in tabs, {"tabs": [{"label": "JavaScript", "language"?: "javascript", "code": "…"}]}: for a developer or a product with an API. - "linkGrid" sets groups of links under a heading each: a page of resources, or the places to go next. - "references" lists the sources a page's claims rest on: at the foot of a page that cites them. - "banner" is a notice at the top of a page about the page itself: on a wiki, where a page needs work. - "github" shows someone's last year on GitHub, read from GitHub as the page is. It draws their contributions over the year, the days they contributed, their longest and current runs of days, and the calendar of every day shaded by how much, linked to their profile. Only a username the brief gives, and once on a page: a developer's or a studio's portfolio, or a project's page. - "contents" lists links to the page's own sections, its h2s. Use it at the top of a long page with several sections. - "scenes" changes the picture behind the whole page as it scrolls, each crossfading into the next. It needs the theme's "background" picture, which the page opens on and the scenes are drawn over, so set one. One per page, placed anywhere; it shows nothing of its own in the page, so a section's scene is not also its figure. For a single scrolling page whose sections are each a place or a thing with a picture of its own, as a tour, a portfolio or a set of projects. Only picture URLs the brief gives you. - "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. - Any block of the page's own (not one inside columns) may take "band", "space", "width" and "look". Use bands sparingly, to set a section apart; consecutive blocks with the same band read as one section. Leave them all unset unless the source sets a block apart that way or the owner asks. - Every piece of words a block holds apart from HTML text (a heading, a caption, a figure and its label, a quote and who said it, a price, a button's label, a place's name or note, an event) is a line of inline HTML: as plain as the source, its words may be wrapped in <strong>, <em> or <code>, linked with <a href> (not in a button's label, which is a link already), or set in a <span style> giving font-family (a value from the Theme list), color or font-size, as the source sets them. - 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"; Geist: "var(--font-geist), 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"; Jost: "var(--font-jost), Futura, 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"; Instrument Serif: "var(--font-instrument-serif), 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. - background is a picture by https URL held behind the whole site, which every page scrolls over on frosted panels of the page's colour, an opening with no picture of its own sitting straight on it: for a single scrolling page with a strong sense of place, and only a picture URL the brief gives you. - 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: - Gallery: white walls and near-black ink, one quiet accent, a slim display serif over a clean sans, square corners and wide margins; for photographers, artists, architects and galleries. {"roundness":0,"density":0.15,"scale":0.9,"depth":0,"--font-sans":"var(--font-geist), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-instrument-serif), Georgia, serif","--font-heading-weight":"400","--hero-entrance":"focus"} - Maker: warm oat and clay, one earthy accent, soft corners and a friendly grotesk; for ceramics, homeware, bakeries and small makers. {"roundness":0.4,"density":0.35,"scale":0.75,"depth":0,"--font-sans":"var(--font-dm-sans), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-bricolage), ui-sans-serif, system-ui, sans-serif","--font-heading-weight":"600","--hero-entrance":"rise"} - 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"}

The site's pages that hold some words, best first: titles starting with them, then titles holding them, then descriptions and page text; a question no page holds word for word is matched in English, stems and all. Each with its path, url, title, description and the passage the words are in, the first 20 of `total`: the same rows as the site's search page and /search.json?q=.

Tell the maintainers of miow what you needed and did not find, what is wrong, or what broke. One issue per call, in 300 characters at most. Reports are read, not published.

Put a site nobody owns yet on a domain your human already has; once someone owns the site, its domain is set only from its settings. Returns the DNS records they must set where they bought it: first a TXT record proving the domain is theirs, then the records that point it here. The site moves to the domain once those records are seen; call domain_status to check.

Give the site a category tree and make it a wiki, or change its tree. A wiki's pages live in its categories, each with a version and a history of every save, and are written with save_wiki_page, not write_site. The tree is sent whole: each node's slug is its path segment, and its metadataKeys are the facts a page under it carries, a select key becoming a filter on the category's page.

Put the site back as it was before a change, undoing it and every change since. Take the change id from history. The undo is itself a change, so it can be undone too.

Change some fields of one block on a page, by its id from read_page, and leave the rest of it and every other block as they are: the way to change a price, a line of text or a picture without resending the page. A block keeps its type. On a wiki, the block tools change its footer; save_wiki_page changes its articles.

Copy an image from a URL into miow's store and get back the URL to use in a pictures block. Up to 10 MB. JPEG, PNG, GIF, WebP and AVIF are kept as they are; an SVG is drawn as a PNG at twice its size, and refused if it holds a script or links to other files. Use it for an image on someone else's server, which may move or vanish.

A wiki page's revisions, newest first: version, kind of change, message, who and when, and what each changed block by block. Pass a revision id to restore_wiki_page to put the page back as it was.

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; to change part of one, update_block, insert_block, move_block and remove_block leave the rest of it as it is. Every write can be undone (history, undo). The input schema gives every block's fields. The reply's notes say what the write changed of what you sent. 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 "search" is the site's search results page, which every site has, with a search box on every page; no page takes it. - path "_footer" is not a page to visit but the footer shown under every page: addresses, hours, contact details. Content, locations 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 the id of a block you add, and keep every id a page was read with, so a wiki page's history matches its blocks one for one. Blocks - A page is a list of blocks, stacked vertically. Every page has exactly one h1: an opening hero's heading, a product's or a products list's with a menu, or else an h1 at the top of its first content block. - "hero" is a heading, a sentence or two of plain text, and optionally one button. It opens a page, its heading the h1: use one on the home page and on pages that sell something. With "call": true it is a call to action further down instead: at most one on a page, usually last, asking for one action, with a button. Its image is under the same rule as a pictures block. Give "subheading": true where its words are a subheading rather than a sentence (a line or two, often set as headings at the source). A "backdrop" at most once 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. An opening with nothing behind it always fits its words, so give it no height. - "content" holds HTML, plain and semantic: h1–h4, p, ul, ol, li, a, strong, em, blockquote, table, hr. No class, style or script: they are stripped. No img either: a picture goes in a pictures block. An iframe embeds a YouTube video, a Google or Apple map, or a Zeffy donation or ticket form, its src the form's own zeffy.com address. After a hero, headings start at h2. - "columns" sets 2–4 columns side by side, 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" (up to 12 columns then); cells may sit lower than their neighbours or overlap. With "beside": true and one column, it is a facts panel beside the text instead: on a page about one thing (a product, a place, an organisation), its usual content a picture and a two-column table of facts. - "pictures" shows pictures, or video files that play: one is a figure, several a row the visitor scrolls sideways, or with "grid": true a gallery to look over rather than step through. Use only picture and video URLs the brief gives you; never invent one. For any gallery or slideshow on a site being moved across, one pictures block holding each picture once, in order, without the slideshow's counters ("Image 1 of 12") or its thumbnails. A YouTube link is an iframe in a content block. - "product" makes its page one thing for sale. 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. A service is a product with "service": true; its button reads Book. A thing a buyer downloads once they have paid (an ebook, a pattern, a track) carries "file": keep it as read, never write one. - "list" lists pages of the site, read as the page is: "under" a section's index page, "newest" a blog's latest posts, "chosen" those named, in order, or "products" the product and service pages, newest first. A shop with several lists gives each list's products block a "menu" of links to all of them, [{"label": "All", "href": "/shop"}, …]; the block then heads the page with its title, so the page needs no other h1. A list is drawn from each page, so never copy a product's pictures, name or price onto another page; list it. - "donate" takes gifts for a charity or a cause, and shows once the site takes payment. Use it only where the brief asks for donations, with the words that ask for them before it, and "amounts" and "monthly" only where the brief gives them. - "stats" sets figures in a row, each "label" saying what its "value" counts: years open, customers served, awards. Only figures the brief gives. - "testimonial" is one person's words about the business. Only quotes the brief gives, never one written for them. - "poem" sets one poem, or a song's words, line for line as written. 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. - "events" lists exhibitions, shows, talks or performances. Give every event in one block, in any order: an event moves under the other heading on its own once it ends. Never split a list into upcoming and past by hand, and never write its dates into the text as well. Its headings are h2s, so a page about events opens on an h1 before it. - "locations" sets out where a business is and when it is open. Its image is under the same rule as a pictures block. The page groups the days ("Mon–Fri 8am–6pm") and says whether each is open now, by its own clock, so never write hours, an address or its phone number into a content block as well. Every shop, studio or office's address and hours go in one, on its contact or visit page and in the footer; a page about several gives every one in one block. Only hours given as regular opening hours: visits by appointment, or a reading on the third Tuesday of the month, are words in a note or a content block. Its names are h2s, or h3s under its heading. - "codeTabs" shows code to copy in tabs, {"tabs": [{"label": "JavaScript", "language"?: "javascript", "code": "…"}]}: for a developer or a product with an API. - "linkGrid" sets groups of links under a heading each: a page of resources, or the places to go next. - "references" lists the sources a page's claims rest on: at the foot of a page that cites them. - "banner" is a notice at the top of a page about the page itself: on a wiki, where a page needs work. - "github" shows someone's last year on GitHub, read from GitHub as the page is. It draws their contributions over the year, the days they contributed, their longest and current runs of days, and the calendar of every day shaded by how much, linked to their profile. Only a username the brief gives, and once on a page: a developer's or a studio's portfolio, or a project's page. - "contents" lists links to the page's own sections, its h2s. Use it at the top of a long page with several sections. - "scenes" changes the picture behind the whole page as it scrolls, each crossfading into the next. It needs the theme's "background" picture, which the page opens on and the scenes are drawn over, so set one. One per page, placed anywhere; it shows nothing of its own in the page, so a section's scene is not also its figure. For a single scrolling page whose sections are each a place or a thing with a picture of its own, as a tour, a portfolio or a set of projects. Only picture URLs the brief gives you. - "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. - Any block of the page's own (not one inside columns) may take "band", "space", "width" and "look". Use bands sparingly, to set a section apart; consecutive blocks with the same band read as one section. Leave them all unset unless the source sets a block apart that way or the owner asks. - Every piece of words a block holds apart from HTML text (a heading, a caption, a figure and its label, a quote and who said it, a price, a button's label, a place's name or note, an event) is a line of inline HTML: as plain as the source, its words may be wrapped in <strong>, <em> or <code>, linked with <a href> (not in a button's label, which is a link already), or set in a <span style> giving font-family (a value from the Theme list), color or font-size, as the source sets them. - 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"; Geist: "var(--font-geist), 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"; Jost: "var(--font-jost), Futura, 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"; Instrument Serif: "var(--font-instrument-serif), 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. - background is a picture by https URL held behind the whole site, which every page scrolls over on frosted panels of the page's colour, an opening with no picture of its own sitting straight on it: for a single scrolling page with a strong sense of place, and only a picture URL the brief gives you. - 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: - Gallery: white walls and near-black ink, one quiet accent, a slim display serif over a clean sans, square corners and wide margins; for photographers, artists, architects and galleries. {"roundness":0,"density":0.15,"scale":0.9,"depth":0,"--font-sans":"var(--font-geist), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-instrument-serif), Georgia, serif","--font-heading-weight":"400","--hero-entrance":"focus"} - Maker: warm oat and clay, one earthy accent, soft corners and a friendly grotesk; for ceramics, homeware, bakeries and small makers. {"roundness":0.4,"density":0.35,"scale":0.75,"depth":0,"--font-sans":"var(--font-dm-sans), ui-sans-serif, system-ui, sans-serif","--font-heading":"var(--font-bricolage), ui-sans-serif, system-ui, sans-serif","--font-heading-weight":"600","--hero-entrance":"rise"} - 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; a picture from anywhere else is refused.