The raw file
{
"format": "aesthetary.ia-structure",
"version": "0.2",
"made": {
"by": "Aesthetary IA Library",
"on": "2026-10-06",
"pattern": "saas",
"pattern_maturity": "built in code and tested"
},
"project": {
"name": null,
"note": "Facts below are the brief. Anything unanswered is listed, never assumed."
},
"copy_guidance": {
"source": "Aesthetary Website Blueprints: the same copywriting guidance the blueprint pages show",
"how_to_use": {
"formula": "An instruction, not text to publish. Write original copy for this project that does what the formula describes, using the project’s real facts. Never publish the formula, or anything in square brackets.",
"why_it_works": "The reasoning behind the section, for whoever writes the copy. Use it to judge a draft; don’t put it on the page.",
"illustrative_example": "Written for a made-up business to show the formula applied. Never reuse its wording, names, places, numbers or quotes.",
"project_content": "The project’s own facts are the brief’s answers, any entities and project decisions, and the slots marked “to supply”. Fill slots only with real content from the business. If it isn’t available, leave the slot visibly empty and list it; never invent reviews, ratings, registrations, prices or results."
}
},
"brief": {
"answered": {
"main_action": {
"question": "What should a ready visitor do?",
"answer": "Sign up or start using it",
"value": "start"
},
"proof": {
"question": "What proof do you actually have?",
"answer": "Clients who agreed to be named",
"value": [
"clients"
]
}
},
"unanswered": []
},
"site_pattern": {
"id": "saas",
"name": "Software product",
"problem": "A visitor has to understand what the product does and whether it fits, then take the step the product can actually offer: start, join a waitlist, or talk to sales.",
"leads_with": "What it does and for whom, then the honest next step."
},
"primary_action": {
"role": "start",
"label": "Start using the product",
"intent": "Begin using the product, or join the queue for it",
"outcome": "signup",
"implementation": "Build decides (likely navigate)",
"decided": true,
"second_routes": [],
"why": "Only when the product can actually be used today; otherwise a waitlist or a conversation about fit.",
"stated_preference": {
"role": "start",
"label": "Start using the product",
"answer": "Sign up or start using it"
},
"follows_preference": true
},
"page_frame": [],
"pages": [
{
"page": "home",
"name": "Homepage",
"route": "/",
"phone_first": [
"action"
],
"phone_notes": [
{
"module": "action",
"note": "Directly under the proposition; proof and pricing follow."
}
],
"status": "include",
"job": "What it is, whether it fits, and the honest next step.",
"modules": [
{
"module": "proposition",
"name": "What this is",
"jobs": [
"orient",
"explain"
],
"status": "include",
"role": "Positioning",
"latitude": null,
"slots": [
{
"slot": "what",
"name": "What you do, in plain words",
"need": "required",
"content": "to supply"
},
{
"slot": "who",
"name": "Who it is for",
"need": "conditional",
"content": "to supply"
},
{
"slot": "where",
"name": "Where (town or area)",
"need": "conditional",
"content": "to supply"
}
],
"why": "What the product is and for whom.",
"copy": {
"formula": "[What the product does + for whom], then [the result they get + the doubt you remove]",
"why_it_works": "Visitors decide quickly whether the product is for them. Saying what it does and who it’s for, in plain words, beats a clever tagline; the supporting line answers the first objection, like price or setup time.",
"illustrative_example": "“Invoices that chase late payments for you.” Then: “For freelancers and small studios. Send an invoice in a minute; we send the reminders.”"
}
},
{
"module": "action",
"name": "Main action",
"jobs": [
"act"
],
"status": "include",
"role": "Primary action",
"latitude": null,
"slots": [
{
"slot": "primary",
"name": "Primary action (a role, not a label)",
"need": "required",
"content": "to supply"
},
{
"slot": "secondary",
"name": "Second route",
"need": "optional",
"content": "to supply"
},
{
"slot": "reassurance",
"name": "Terms at the action",
"need": "conditional",
"content": "to supply"
}
],
"why": "The honest next step: start, join the waitlist or talk to sales, depending on access.",
"copy": {
"formula": "[Start, join the waitlist or talk to sales], with [free or paid + card needed or not + how to cancel]",
"why_it_works": "Offer the step your product can actually take today. If people can use it now, let them start; if buyers need to check fit, a conversation is the honest action.",
"illustrative_example": "“Start free”, with “No card needed · cancel any time” beside it."
}
},
{
"module": "price-list",
"name": "Prices",
"jobs": [
"reassure",
"explain"
],
"status": "optional",
"role": "Price",
"latitude": null,
"slots": [
{
"slot": "items",
"name": "Item and price (or “from” price)",
"need": "required",
"many": true,
"content": "to supply"
},
{
"slot": "includes",
"name": "What’s included",
"need": "conditional",
"content": "to supply"
},
{
"slot": "tax",
"name": "Tax shown or included",
"need": "required",
"content": "to supply"
},
{
"slot": "extras",
"name": "Extra fees (call-out, deposit, travel)",
"need": "conditional",
"content": "to supply"
},
{
"slot": "depends",
"name": "What changes the price",
"need": "conditional",
"content": "to supply"
},
{
"slot": "updated",
"name": "Last updated",
"need": "optional",
"content": "to supply"
}
],
"why": "Pricing, when it can be shown.",
"copy": {
"formula": "[Plan + who it’s for + price], with what each plan includes",
"why_it_works": "People compare plans to find the one that fits them. Saying who each plan is for helps them choose without reading every feature.",
"illustrative_example": "“Solo · £— a month · up to — clients · reminders included.”"
}
},
{
"module": "steps",
"name": "What happens next",
"jobs": [
"explain",
"reassure"
],
"status": "optional",
"role": "What happens next",
"latitude": null,
"slots": [
{
"slot": "step",
"name": "Step",
"need": "required",
"many": true,
"content": "to supply"
},
{
"slot": "when",
"name": "Time per step",
"need": "optional",
"content": "to supply"
},
{
"slot": "cost",
"name": "Cost per step",
"need": "optional",
"content": "to supply"
}
],
"why": "How it works, step by step.",
"copy": {
"formula": "[What they do first] → [what you do next + how fast] → [the work] → [how it ends + what it costs]",
"why_it_works": "Takes the unknown out of getting in touch: what happens after the first click, who does it, how long it takes and what it costs.",
"illustrative_example": "“1 Sign up with your email. 2 Add your first client. 3 Send an invoice. 4 Pick a plan when you’re ready.”"
}
},
{
"module": "proof-strip",
"name": "Proof",
"jobs": [
"prove",
"reassure"
],
"status": "include",
"role": "Trust & proof",
"latitude": null,
"slots": [
{
"slot": "registers",
"name": "Registrations",
"need": "conditional",
"many": true,
"content": "to supply"
},
{
"slot": "insurance",
"name": "Insurance",
"need": "optional",
"content": "to supply"
},
{
"slot": "reviews-summary",
"name": "Review source, count and date",
"need": "conditional",
"content": "to supply"
},
{
"slot": "clients",
"name": "Named clients (with permission)",
"need": "conditional",
"many": true,
"content": "to supply"
}
],
"why": "Proof, only with evidence behind it.",
"copy": {
"formula": "[Verifiable evidence that reduces hesitation], each with a way to check it",
"why_it_works": "Gives people something they can check, so they don’t have to take your word for it.",
"illustrative_example": "“Used by —, — and — (named with permission).” Before launch, with nothing to show yet, leave this section out."
}
},
{
"module": "faq",
"name": "Questions people ask",
"jobs": [
"reassure"
],
"status": "optional",
"role": "Reassurance",
"latitude": null,
"slots": [
{
"slot": "items",
"name": "Question and answer",
"need": "required",
"many": true,
"content": "to supply"
}
],
"why": "Only the questions people actually ask.",
"copy": {
"formula": "[Real customer objection + direct answer]",
"why_it_works": "Answers the doubts that stop people acting, in the words they use when they ask.",
"illustrative_example": "“What happens to my data if I cancel? You can export everything as CSV, and we delete it after — days.”"
}
},
{
"module": "continuation",
"name": "Where next",
"jobs": [
"act",
"recover"
],
"status": "include",
"role": "Next step",
"latitude": null,
"slots": [
{
"slot": "line",
"name": "Closing line",
"need": "required",
"content": "to supply"
}
],
"why": "The next step at the end of the page.",
"copy": {
"formula": "[The next step, for anyone still reading] + [specific action]",
"why_it_works": "Catches people who read to the end and gives them one clear next step.",
"illustrative_example": "“Send your first invoice today. Start free.”"
}
}
]
},
{
"page": "pricing",
"name": "Pricing",
"route": "/pricing",
"page_pattern": "prices",
"status": "include",
"job": "Plans and what each includes. Proposed, not built.",
"modules": [
{
"module": "price-list",
"name": "Prices",
"jobs": [
"reassure",
"explain"
],
"status": "include",
"role": "Price",
"latitude": null,
"slots": [
{
"slot": "items",
"name": "Item and price (or “from” price)",
"need": "required",
"many": true,
"content": "to supply"
},
{
"slot": "includes",
"name": "What’s included",
"need": "conditional",
"content": "to supply"
},
{
"slot": "tax",
"name": "Tax shown or included",
"need": "required",
"content": "to supply"
},
{
"slot": "extras",
"name": "Extra fees (call-out, deposit, travel)",
"need": "conditional",
"content": "to supply"
},
{
"slot": "depends",
"name": "What changes the price",
"need": "conditional",
"content": "to supply"
},
{
"slot": "updated",
"name": "Last updated",
"need": "optional",
"content": "to supply"
}
],
"why": "The list itself, with tax, extras and what changes the price.",
"copy": {
"formula": "[Plan + who it’s for + price], with what each plan includes",
"why_it_works": "People compare plans to find the one that fits them. Saying who each plan is for helps them choose without reading every feature.",
"illustrative_example": "“Solo · £— a month · up to — clients · reminders included.”"
}
},
{
"module": "today",
"name": "On today",
"jobs": [
"explore",
"act"
],
"status": "optional",
"role": "The offer",
"latitude": null,
"slots": [
{
"slot": "items",
"name": "Today’s items",
"need": "required",
"many": true,
"content": "to supply"
},
{
"slot": "date",
"name": "Date it applies to",
"need": "required",
"content": "to supply"
}
],
"why": "Menus that change daily: what’s on today, dated.",
"copy": {
"formula": "[What’s different this week, dated] + [price]",
"why_it_works": "Shows any price that only applies now, dated, so the main list stays true.",
"illustrative_example": "“Prices from 1 November: —.” Only for a change that’s really coming."
}
},
{
"module": "faq",
"name": "Questions people ask",
"jobs": [
"reassure"
],
"status": "optional",
"role": "Reassurance",
"latitude": null,
"slots": [
{
"slot": "items",
"name": "Question and answer",
"need": "required",
"many": true,
"content": "to supply"
}
],
"why": "Payment, deposits, finance, cancellations: only if people ask.",
"copy": {
"formula": "[Real customer objection + direct answer]",
"why_it_works": "Answers the doubts that stop people acting, in the words they use when they ask.",
"illustrative_example": "“What happens to my data if I cancel? You can export everything as CSV, and we delete it after — days.”"
}
},
{
"module": "action",
"name": "Main action",
"jobs": [
"act"
],
"status": "include",
"role": "Primary action",
"latitude": null,
"slots": [
{
"slot": "primary",
"name": "Primary action (a role, not a label)",
"need": "required",
"content": "to supply"
},
{
"slot": "secondary",
"name": "Second route",
"need": "optional",
"content": "to supply"
},
{
"slot": "reassurance",
"name": "Terms at the action",
"need": "conditional",
"content": "to supply"
}
],
"why": "Book, order or ask for a quote from the page where the decision is made.",
"copy": {
"formula": "[Start, join the waitlist or talk to sales], with [free or paid + card needed or not + how to cancel]",
"why_it_works": "Offer the step your product can actually take today. If people can use it now, let them start; if buyers need to check fit, a conversation is the honest action.",
"illustrative_example": "“Start free”, with “No card needed · cancel any time” beside it."
}
}
]
},
{
"page": "stories",
"name": "Customer stories",
"route": "/customers/{project}",
"page_pattern": "case-study",
"one_per": "project",
"status": "include",
"job": "Proof from named customers. Proposed, not built.",
"modules": [
{
"module": "item-header",
"name": "Item summary",
"jobs": [
"orient",
"explain"
],
"status": "include",
"role": "Positioning",
"latitude": null,
"slots": [
{
"slot": "title",
"name": "Title",
"need": "required",
"content": "to supply"
},
{
"slot": "summary",
"name": "One-line summary",
"need": "required",
"content": "to supply"
},
{
"slot": "status",
"name": "Price, status or date",
"need": "conditional",
"content": "to supply"
}
],
"why": "Project, client (if named), what it was.",
"copy": {
"formula": "[The project + who it was for] + [the problem it solved + the result]",
"why_it_works": "Tells a future client in one look whether this project is like theirs.",
"illustrative_example": "“How a two-person studio stopped chasing invoices by hand.”"
}
},
{
"module": "media",
"name": "Pictures of the real thing",
"jobs": [
"demonstrate",
"prove"
],
"status": "include",
"role": "Supporting evidence",
"latitude": null,
"slots": [
{
"slot": "images",
"name": "Image with alt text and caption",
"need": "required",
"many": true,
"content": "to supply"
},
{
"slot": "credit",
"name": "Photographer or source",
"need": "conditional",
"content": "to supply"
}
],
"why": "The real work. Before/after only of the same job, same angle.",
"copy": {
"formula": "[A photo of the real thing] + [what it shows + where or when]",
"why_it_works": "Shows the real thing, so people can judge it for themselves.",
"illustrative_example": "“The reminder settings the studio uses, screenshot from March.”"
}
},
{
"module": "credits",
"name": "Who did what",
"jobs": [
"explain",
"prove"
],
"status": "include",
"role": "Supporting evidence",
"latitude": null,
"slots": [
{
"slot": "role",
"name": "Role and scope",
"need": "required",
"content": "to supply"
},
{
"slot": "collaborators",
"name": "Collaborators",
"need": "optional",
"many": true,
"content": "to supply"
}
],
"why": "What this business did, and who else worked on it.",
"copy": {
"formula": "[Your role + scope] + [who you worked with]",
"why_it_works": "Makes clear what you did, so the work proves your part and not someone else’s.",
"illustrative_example": "“Set up by the studio; we helped import their old invoices.”"
}
},
{
"module": "steps",
"name": "What happens next",
"jobs": [
"explain",
"reassure"
],
"status": "optional",
"role": "What happens next",
"latitude": null,
"slots": [
{
"slot": "step",
"name": "Step",
"need": "required",
"many": true,
"content": "to supply"
},
{
"slot": "when",
"name": "Time per step",
"need": "optional",
"content": "to supply"
},
{
"slot": "cost",
"name": "Cost per step",
"need": "optional",
"content": "to supply"
}
],
"why": "How it was done, when the process is part of the proof.",
"copy": {
"formula": "[What they do first] → [what you do next + how fast] → [the work] → [how it ends + what it costs]",
"why_it_works": "Takes the unknown out of getting in touch: what happens after the first click, who does it, how long it takes and what it costs.",
"illustrative_example": "“1 Sign up with your email. 2 Add your first client. 3 Send an invoice. 4 Pick a plan when you’re ready.”"
}
},
{
"module": "outcome",
"name": "What changed",
"jobs": [
"prove"
],
"status": "include",
"role": "Supporting evidence",
"latitude": null,
"slots": [
{
"slot": "measure",
"name": "Measure, method, date",
"need": "required",
"content": "to supply"
}
],
"why": "Only a measured result, attributed correctly.",
"copy": {
"formula": "[Measured result + how and when it was measured]",
"why_it_works": "Shows the result in a way people can believe: what changed, measured how, and when.",
"illustrative_example": "“Average days to get paid fell from — to — over six months, from the studio’s own records.” Only include it if it was measured."
}
},
{
"module": "reviews",
"name": "What clients say",
"jobs": [
"prove"
],
"status": "optional",
"role": "Supporting evidence",
"latitude": null,
"slots": [
{
"slot": "quotes",
"name": "Quote, name or initials, context, date, where it was left",
"need": "required",
"many": true,
"content": "to supply"
}
],
"why": "The client’s words about this project, with permission.",
"copy": {
"formula": "[A real customer’s words + the specific result], with name or initials, place, date and where it was left",
"why_it_works": "Lets someone like the visitor say it for you. A quote about the job they need does more than general praise.",
"illustrative_example": "An illustration of the shape, for a made-up product: “I haven’t written a reminder email since March.” —, illustrator. Use real, attributed quotes."
}
},
{
"module": "continuation",
"name": "Where next",
"jobs": [
"act",
"recover"
],
"status": "include",
"role": "Next step",
"latitude": null,
"slots": [
{
"slot": "line",
"name": "Closing line",
"need": "required",
"content": "to supply"
}
],
"why": "The next project, or the action.",
"copy": {
"formula": "[The next step, for anyone still reading] + [specific action]",
"why_it_works": "Catches people who read to the end and gives them one clear next step.",
"illustrative_example": "“Send your first invoice today. Start free.”"
}
}
]
}
],
"left_out": [],
"constraint_profiles": [],
"open_questions": [
"Multi-page product sites.",
"Comparison pages (no evidence yet)."
],
"receives": {
"design": [
"pages[].name, job and order (the hierarchy)",
"pages[].modules[] in order, with jobs and role",
"status “depends” (unresolved) vs optional",
"page_frame with required/recommended strength",
"pages[].phone_first and phone_notes (the phone order)",
"primary_action label and intent"
],
"build": [
"pages[].route and one_per (routes and repeating pages)",
"pages[].modules[] in order",
"modules[].slots with need, many and any profile obligation",
"primary_action.intent and second_routes (implemented per platform)",
"page_frame (required/recommended)",
"left_out (must stay out)",
"entities, when the project names them"
]
},
"handoff": {
"design": "Read pages[] in order and modules[] in order: that is the hierarchy. jobs[] say what each module must achieve; status \"depends\" means unresolved, not optional. Look, type, imagery and Elements are Design’s; nothing here prescribes them.",
"build": "Make one route per page (one per entity where one_per is set), modules in the given order, every slot with need \"required\" filled before ship. Implement each action so it achieves its intent on this project’s platform. Do not read why as an instruction.",
"qa": "Check that each included module does its jobs, required slots are filled with real content, left_out items stayed out, and the primary action leads where its label says.",
"copy": "Write each section’s copy from copy.formula and the project’s real facts; check it against copy.why_it_works. Never reproduce copy.illustrative_example or publish text in square brackets. The guidance is a set of recommendations to test with real visitors, not a promise of results."
}
}