Questions

Short answers about what Aesthetary does today, with a link wherever there’s more. Where something isn’t built yet, the answer says so.

Getting started

What is Aesthetary?

A set of skills, workflows and design research for making a website with AI, from the first research to keeping it running after launch. The work is split into eight phases: Prepare, Research, Plan, Structure, Design, Build, Test and Improve. Each phase ends in a file you keep with the project, so you and your coding agent work from decisions that are written down instead of guessing them again in every session.

About Aesthetary

Who is it for?

Anyone making a website with AI doing some of the work. Who it’s for splits that into four: business owners and startups, web professionals, students and educators, and organizations and programs. Each has its own page saying where to start.

Who it’s for

Where do I start?

Start here asks what you want to do and sends you to the right place. If you’re new to working with a coding agent, begin with Prepare: running a session without handing over your decisions, and keeping the work safe as you go. If you already have a project, start at the phase you’re in.

Start here

Do I have to go through the phases in order?

No. Each phase page says what it needs coming in and what it hands on, so you can pick a project up halfway through.

Start at Research

Do you run workshops?

Yes, for universities, institutions and teams: a guest lecture, a hands-on workshop, a program of several sessions, or training shaped around your own work. They run in English, in Tirana or online.

Workshops

Learning

What are the skills?

106 skills, grouped by phase. 103 are Aesthetary Originals: a short video lesson with captions (most are narrated), an outline and a takeaway. Two more are by a contributor, in their own name and branding. One points to the official guide from the people who make the tool, because they teach it better.

Learn

Is my progress saved?

Yes. Without an account, the tasks you tick and what you write in their worksheets are kept in this browser, and Outputs lists your worksheets with a Download all my work button. A free account keeps them too, with your projects, on every device you sign in on. The first time you sign in, you can add what this browser already has to your account. Watching a video never ticks a task.

Outputs

Does Aesthetary certify or accredit anything?

No. There are no scores, badges or certificates, and Aesthetary isn’t an accredited provider. The Test phase helps you check a site against published standards and write down what you checked; that record is yours to show or keep.

Making websites

Does Aesthetary build my website?

No. You and your coding agent build it. Aesthetary gives you the phases, the skills, the files to write and the checks to run. It doesn’t run your build and doesn’t connect to your tools.

Which coding agents does it work with?

Any agent that reads files. Agent guides are Markdown and the Aesthetic records are JSON, so Claude Code, Codex, Cursor or another agent can work from them.

What are the files?

Plain Markdown and JSON that live in your project’s repository: a source inventory and claims list from Research, brief.md and requirements.md from Plan, a site plan and content model from Structure, direction.md and tokens.json from Design, an agent guide or AGENTS.md for Build, a QA record and a pre-send gate, and a maintenance routine. The repository is the project record, and Git keeps its history.

How do I check my site?

The Test phase takes your site’s address once and opens free testing tools with it filled in: speed, accessibility, markup, links and security headers. Aesthetary doesn’t run the checks or see the results. The phase also covers what a machine can’t check, such as whether the claims on the page are true.

Test

Design and resources

What are Aesthetics?

Documented visual languages, used in the Design phase. 28 are Ready to Build: each has structured rules, the evidence behind each rule, and an agent guide your coding agent can read. The other 45 are researched but not ready to recommend: 17 are in cultural review and 28 are in research.

Browse the Aesthetics

What are Elements?

The parts Aesthetics are built from: a grid, a print effect, a surface, a type system, sorted into eight areas. The ones with a specimen are drawn so you can see exactly what the name means.

Color holds 25 palettes: 13 taken from the Aesthetics’ cited color rules and 12 written by Aesthetary for a feeling, each on its own page with its proportions, a sample website set in it, contrast by use, and the colors that aren’t for text.

Elements

What are Layouts?

13 layouts of two kinds. 6 website blueprints for common kinds of site: which pages a site needs and what goes on each. Answer a few questions and the plan redraws, then download it as JSON for your coding agent or Markdown to read. They’re worked out from research and real briefs, and no site has been built from one yet; each page says so.

7 page layouts: the pages most websites need, and how to lay out each one. Each blueprint uses several of them.

Layouts

What is Copy?

Copy & Content: website copy, before and after. 22 examples, from the headline on the first screen to being quoted in AI answers, each saying what changed and why the second version works better.

Copy & Content

What’s in Resources?

233 tools, testers and pieces of official documentation, sorted by the phase you’d use them in, with notes on cost, licensing and upkeep.

Resources

Your work and community

Do I need an account?

No. Everything except Projects works without one. A free account keeps your ticks, worksheets and projects, with their pictures, on every device you sign in on. Anyone 18 or older can make one with an email address; there’s no password. The first time you sign in, you can add what you’ve done in this browser to your account, or keep it in the browser.

Create an account

What is Work?

The place for what you make and keep here. Today that’s Projects, kept in your free account; Outputs, the worksheets you’ve written on the phase pages; and Saved. Download all my work saves your worksheets, ticks and saves in one file. Portfolio and Contributions are listed too, marked Not available yet.

Outputs

Where is what I’ve saved kept?

In this browser. Saved lists what you’ve saved from Aesthetics, Elements, Layouts, Skills and Resources. It doesn’t move to another device, and clearing your browser’s site data removes it.

Saved

Can I contribute?

Yes. On each Aesthetic page you can say how well the page gets the language right, from love it to hate it. If you have standing in one of the traditions in cultural review, you can offer to review its research. Corrections, missing sources and missing visual languages are welcome by email at hello@aesthetary.com.

Contribute

What is Talent?

Profiles that show the websites someone has built, each opening on their work. Only people who agree to be listed appear.

Talent

Pricing and access

Does it cost anything?

No. Everything on the site is free today, accounts included, and only Projects needs an account.

Is there an API?

No. Each Aesthetic is published as a static JSON file at data/v1/<slug>.json, with every claim, its basis and its sources. There’s no endpoint and no versioning promise yet.

For developers

Trust and research

Where does the information come from?

Documents and artifacts, cited claim by claim. All 28 Aesthetics ready to build cite sources, 480 between them, and 575 claims have a source attached. A claim with no source yet says so where it appears instead of being filled in. Standards on the phase pages link to the people who publish them.

How the research works

Why are some Aesthetics more complete than others?

Depth before breadth, on purpose. 28 of the 28 Aesthetics ready to build hold at least one documented claim, and some have been read far more closely than others. The unevenness is shown, not smoothed over: a thinly researched Aesthetic is a gap in our reading, not a lesser aesthetic.

Who checks it?

Research proposes a claim and a separate review decides whether the evidence supports it. A claim can survive the reading and still be narrowed because the evidence doesn’t reach as far as the wording did.

Review by people with standing in a tradition is something Aesthetary needs and doesn’t have enough of yet. Cultural review is where that starts.

What is cultural review?

17 Aesthetics come from specific cultures and communities. New research on them waits for review by people with the standing to judge it before it’s published. Their pages stay open while the review happens.

Cultural review

How are references and images handled?

Source material belongs to the institutions and authors cited, and nothing here relicenses it. Licenses are recorded source by source, and Using this material lists the ones recorded so far.

Licensing