Lesson 1 of 110 of 6 steps

Lesson 1 · about 15 minutes

See it before it's built

Before anything is built, you'll see your app. Your agent draws two or three versions as pictures you can open in your browser, and you pick the one that feels right. Changing a picture costs nothing; changing a built app costs time.

Start every app, and every new screen, with two or three HTML mockups. Pick one, ask for changes, then build. It's the cheapest moment to change your mind.

Before any build, the agent makes 2–3 options side by side in one local HTML file at phone width, and you pick one. It's quick, it's thrown away afterwards, and it stops you building the wrong thing.

How much have you built before?
This lesson's wording changes to match.
FreeNo code to writeNothing goes online

Tap one to pick it.

What you'll make

  • Two or three pictures of your app's main screen
  • One you've picked, with your changes
  • A clear yes or no on whether it suits a web app

You'll need: Claude Code (see below), and an idea, however rough.

Before you start

  1. Install Claude Code by following its quickstart. It works on Mac, Windows and Linux.
  2. Open the Terminal app, make a folder for your app and start Claude Code in it:
Type in Terminal
mkdir my-app && cd my-app && claude

Everything your agent makes stays in that folder. Optional but recommended: install the Idea to Icon skill (on the front page), so your agent follows these lessons for you.

Your agent will sometimes get things wrong, or misunderstand you. That's normal, not a sign you're doing it badly. Say what you see, in your own words, and it'll fix it. Each lesson shows what to say when things go wrong.

1

Say what you want

Describe the app like you'd tell a friend: who it's for, and the one thing they'll do most. You don't need a plan, or the right words.

Say to your agent
I'd like an app to book piano lessons with me. Parents pick a free slot and get a confirmation email. Mock up the main screen first, two or three versions, before building anything.

Swap in your own idea. The important part is the last sentence: it tells your agent to show you pictures first.

Good to include: who it's for, what they do most, and whether it's mainly on a phone or a computer.

2

Answer a few questions

A good agent asks a little before drawing. With the Idea to Icon skill installed, it asks at most three questions.

Who will use it most: you, or the parents booking?
Will they mostly book on a phone?
How long is a lesson, and which days do you teach?

Answer in a few words. "Not sure" is a fine answer too: it'll pick something sensible and tell you.

3

Look at the mockups

Your agent makes one page with the versions side by side, and opens it in your browser.

Tap one to pick it.

You should see

Two or three phone-sized screens, each with a short note on what's different and which one your agent would pick. Tap one in this example.

They're just pictures: none of the buttons work yet, and nothing is online.

Nothing opened in my browser
Ask "Open the mockups for me". Or ask where the file is: it's usually mockups/ in your app's folder, and you can double-click it.
4

Pick one, then change it

Say to your agent
B is best. Make the book button bigger and show the next free slot at the top. Show me again.

Go round as many times as you like. When it looks right, say so: that's when building starts.

Keep each round small: one or two changes, then a fresh screenshot. Cheaper to iterate on HTML than on the app.

5

Check it suits a web app

Most ideas do: logs, trackers, booking pages, club sites, tools for a small business, even paid products. A few don't, and it's better to know now.

Say to your agent
Is there anything about this idea that a web app can't do well?

Your agent should say if it needs things the web can't reach (some Bluetooth on iPhone, home-screen widgets), big 3D graphics, or being found in the App Store.

6

Keep the mockups

The mockups stay in a mockups/ folder. Later, when you want a new screen, the same thing happens: pictures first, then building.

Lesson 1 doneYou just saw your app as pictures and picked the one that feels right.
Next up · lesson 2, about 20 minutesPut a tiny app online and on your phone, so you know the whole path works.

Did it work?

Tick these off. They're saved in this browser, so you can come back later.

  • I described my app in a sentence or two
  • I saw two or three mockups in my browser
  • I picked one and asked for a change
  • My agent told me whether it suits a web app