IdeatoIcon

How much have you built before?

Describe the app you want. Your AI agent builds it. Go from a prompt to a live, installable app in an afternoon. The shortest path from prompt to production PWA.

No code to write. You'll see it sketched first, then it's live on your phone at its own web address, with somewhere to keep your data, photos and emails, all in one place. Mockups first, then Cloudflare for hosting, a database, file storage and email, with tests and a "put it live" you approve. A free course, and a skill your agent follows. A Claude Code skill and course: Workers + static assets, D1, R2, Email Service, Cron, offline sync, emailed-code auth, SW update flow, Playwright checks, GitHub Actions deploys and rollbacks. Opinionated; no front-end framework needed.

Start the course
FreeAsks before going liveUndo any release
you β€Ί

Book a lesson

Tuesday 25th10:00 Β· 45 min
Book this lesson
🎹
databaseemailtests passedyou said yes
lessons.you.workers.dev Β· live
ideasketchbuildcheckicon

How it works

Three things you do. Your agent does the rest.

1Say what you want

In plain words, like telling a friend. "A log for feeds and nappies we can both use."

Describe the app and who it's for. The agent asks up to three questions, then mocks it up.

The skill scopes it (users, primary action, device), checks it suits the web, and drafts 2–3 HTML mockups.

references/design-and-ux.md
2Pick what you see

It shows you pictures of a few designs. Tap the one you like, and say what to change.

Pick a mockup; it builds it and runs it on your computer so you can try it before anything is online.

Build on Workers + static assets, D1 via the Worker only, local wrangler dev, unit + Playwright checks, screenshots.

npx wrangler dev β†’ localhost:8787
3Say "put it live"

It checks everything, asks you, then your app is online. Add it to your home screen like any app.

It runs the tests, asks you, and deploys to Cloudflare. Undo is one step if you change your mind.

Migrations then deploy, or push to main with Actions. SW version bump, rollback via wrangler rollback.

npx wrangler deploy

Set up once, in about ten minutes

Log in once. After that, you just talk.

No servers to rent and no settings pages to learn. You install an agent, sign in to Cloudflare one time, and from then on "try it" and "put it live" are just things you say.

1
Install an agent

Claude Code, from its website. It runs on your Mac or PC and can install anything else it needs.

2
Sign in to Cloudflare, once

Make a free account, then run one line. A browser window opens: click Allow, and you're done.

npx wrangler login
3
Say what you want

"Build me a booking page for my piano lessons." The course takes it from there.

$
Opening your browser to log in…
Successfully logged in.
dash.cloudflare.com
Allow Wrangler to make changes to your Cloudflare account?

Workers, databases and storage for your apps.

CancelAllow
Try itβ€œLet me try it”

Your agent runs it on your computer and opens it in your browser. Change things and see them straight away.

npx wrangler dev β†’ localhost:8787
Put it liveβ€œPut it live”

One command, about ten seconds, or push to GitHub and it goes live once the tests pass. You get a free web address straight away.

npx wrangler deploy β†’ your-app.you.workers.dev
Change itβ€œMake the buttons bigger”

It changes it, shows you a screenshot, and puts it live when you say yes. Phones pick up the new version.

edit β†’ test β†’ screenshot β†’ you say yes

What it costs: Cloudflare's free plan is plenty for a family app or a club. Sending email to other people needs their $5-a-month plan and your own domain. See what's included.

Everything in one place

Pages, a database, files, email and timers. One account.

This is what makes it easy. Your app's code, its database, its photo storage, its email and its scheduled jobs all live at Cloudflare, joined up in one short settings file. One login, one "put it live". It isn't only for home-screen apps: websites, booking systems, team tools and APIs work the same way.

wrangler.jsonc
{
  "name": "club-stats",
  "assets": { "directory": "./public" },  "d1_databases": [{ "binding": "DB", … }],  "r2_buckets": [{ "binding": "PHOTOS", … }],  "kv_namespaces": [{ "binding": "SETTINGS", … }],  "send_email": [{ "name": "EMAIL" }],  "triggers": { "crons": ["0 8 * * 1"] },  "ai": { "binding": "AI" }}

Your agent writes this. Each line plugs one block into your app.

Running costs

What Cloudflare charges to host your app

The course and the skill are free. These are Cloudflare's own prices, paid to them, not to us. Most people start on their free plan.

Cloudflare Β· Free plan$0
  • 100,000 requests a day for your app's code
  • Pages themselves: free and unlimited
  • A database up to 5 GB
  • 10 GB of files and photos
  • Email to your own verified address

Plenty for a family app, a club, or trying an idea.

Cloudflare Β· Workers Paid$5 a month
  • Email to anyone: sign-in codes, customers, members
  • 10 million requests a month, then pay as you go
  • Longer-running jobs and bigger limits

Worth it once real people sign in by email, or the app grows.

A domain name Β· from any registrar~Β£10 a year
  • A name like yourapp.com instead of a workers.dev address
  • Needed to send email from your own address

Optional. Prices vary by name.

Figures from Cloudflare's pricing page, checked November 2026; they can change, and Cloudflare charges in US dollars. Your AI agent (such as Claude Code) is a separate subscription with its own provider.

Why a web app

One app. A website, a home-screen app, or a paid product.

You build it once, as a web app (a "PWA"). The same code is a normal website anyone can open from a link, an app people add to their home screen, and, with sign-in and payments, a product people pay for.

your-app/One codebasebuilt with your agent
πŸ”—A websiteAnyone with the link. Found by search engines.
πŸ“²On the home screenFull screen, works offline, notifications and more.
πŸ”‘Behind a sign-inPrivate for a family, or paid plans for customers.
Web app (PWA)App store app
Get itβœ“ Open a link, then "Add to Home Screen"Search the store, download
Updatesβœ“ Everyone has it the same dayStore review, then people update
iPhone, Android, computerβœ“ One version for all of themOften built twice
Works offlineβœ“ Yes, if it's built for itβœ“ Yes
Notificationsβœ“ Yes. On iPhone, once it's on the home screenβœ“ Yes
Store fees and reviewβœ“ NoneYearly fee, a cut of payments

When it isn't the right fit: big 3D games, apps that need phone features the web can't reach (like some Bluetooth on iPhone, or home-screen widgets), or when being in the App Store is how people will find you. Your agent can tell you early if your idea is one of these.

On a phone

What your web app can do

Once it's on the home screen, a web app can do most of what people expect from an app: reminders, a badge on the icon, the camera, Face ID, Apple Pay. iPhone allows a little less than Android, and your agent tells you before building something that won't work.

FeatureiPhoneAndroid
NotificationsReminders and alerts, even when the app is closed. Yesonce on the home screenYes
Badge on the iconA number on the app icon, like unread messages. Yesonce on the home screenYesa dot, while a notification is unread
Works offlineOpens and saves with no signal, then syncs. YesYes
Keep the screen onWhile a timer or a recipe is showing. YesYes
Share outSend a link, photo or file to any app. YesYes
Share inAppear in the phone's share menu to receive things. NoNoYes
LocationWhere you are, while the app is open. YesYes
Camera and microphonePhotos, video, voice notes, scanning. YesYes
Face ID or fingerprint sign-inPasskeys instead of passwords. YesYes
Apple Pay or Google PayPay in a tap. YesYes
Lock-screen controlsPlay, pause and skip from the lock screen. YesYes
SpeechRead aloud, and dictation. YesYes
Motion and tiltSteps, shakes, which way the phone is held. YesYes
VibrationSmall buzzes for taps and alerts. NoNoYes
Sync in the backgroundFinish sending after the app is closed. NoNoYes
App shortcutsLong-press the icon for quick actions. NoNoYes
Bluetooth and NFCTalk to nearby devices and tags. NoNoYes

Not possible for web apps: home-screen widgets, tracking location in the background, running all the time in the background, and being found in the App Store. On Android, a web app can be listed on Google Play.

iPhone support from firt.dev's iOS web app notes, checked November 2026. This changes with each iOS release; your agent checks before promising a feature.

It sends email too

From your own address, set up alongside the app.

Sign-in codes, booking confirmations, quotes, receipts, reminders and weekly summaries, sent from an address like hello@yourdomain. Your agent sets it up with your domain, sends a test to you first, and asks before anything goes to a real customer.

  • Needs your own domain, and Cloudflare's $5-a-month plan to email anyone other than yourself
  • Replies come back to your normal inbox
  • An unsubscribe link on anything that isn't essential
Inbox4 new
πŸ”‘
Club statsYour sign-in code is 482 913
09:12
β™ͺ
Piano lessonsBooking confirmed: Tue 25 Nov, 10:00
08:40
🧾
Your plumberQuote #142 Β· Β£133 Β· tap to accept
Mon
🌱
Allotment trackerYour week: watered 5 times, 2 jobs left
Sun

What people build

Pip's log
Last feed1h 12m ago
WetDirty
Family logsFeeds, chores, medicines, shared between phones. Private, on the home screen.
Your season
14matches100runs6wickets16.7avg
Club and team statsScores, seasons, badges and a map of grounds. Sign-up for anyone at the club.
lessons.example
Book a lesson
Book Tue 10:00
Booking pagesLessons, a holiday let, a room at the club. A public page with a calendar.
jobs.example
Quote #142Sent
Boiler serviceΒ£95
PartsΒ£38
TotalΒ£133
Send to client
Tools for a small businessQuotes, stock, job sheets, a client portal. Behind a sign-in for your team.
This week
πŸ’§ WaterπŸƒ Run🌱 Plants
5 day streak
TrackersHabits, training, plants, the allotment. Reminders on the home screen.
yourproduct.example/pricing
FreeΒ£0
ProΒ£6
TeamΒ£20
Start free
Your first paid productSign-up, plans and payments, for a few customers or many.

The course Β· about four and a half hours, in short lessons

Eleven steps from an idea to an app people use.

Each step has a picture of the idea and the words to say to your agent. You don't need to write code. You do need to look, try it and say what feels wrong.

1

See it before it's built

Ask for two or three mockups first. Picking between pictures is quicker than describing a screen, and much cheaper than changing code later.

Mock up two versions of the main screen before building anything.
Open lesson 1 β€Ί

Tap one to pick it.

2

Get your first app online

Make a free Cloudflare account, sign in once, and put a tiny first app at a real web address, then onto your phone's home screen. About 20 minutes.

Log me in to Cloudflare, make me a tiny first app, and put it live when I say yes.
Open lesson 2 β€Ί
πŸ“± Your phonethe app
βš™οΈ Workerchecks and saves
πŸ—„οΈ Databaseyour entries

Every entry goes through the Worker, which checks it before saving. Nothing else can write to your data.

3

Keep every version, and undo in one step

Your app's history goes on GitHub, privately. Every change is saved with a note, and putting it live can happen on its own once the tests pass. If a release goes wrong, step back to the one before.

Put this on a private GitHub repo, and deploy from GitHub after the tests pass.
Open lesson 3 β€Ί
  1. Say "Nice one!" after 10 tapsToday, 14:02
  2. Bigger tap buttonYesterday
  3. Sprout icon for the home screenTue
  4. First versionMon

The green one is live. Try undoing a release.

4

Works with no signal

Entries are saved on the phone first and sent when there's a connection. Nothing is lost in a car park or at the bottom of the garden.

Queue changes on the phone and sync them when it's back online.
Open lesson 4 β€Ί
Try it
On the phone, waiting
Saved on the server
5

Sign-in codes and emails

Sign in with a six-digit code sent by email, so there are no passwords to forget or leak. The same set-up sends confirmations, quotes and reminders from your own address.

Sign in with an emailed 6-digit code; let a partner join with an invite key.
Open lesson 5 β€Ί
From your app
Your sign-in code is 482 913
It works for 15 minutes.

The code types itself in, as it would from the email.

6

Updates that actually arrive

Home-screen apps hold on to old files. Give every release a version number and the app notices, then offers a restart instead of leaving you on last week's version.

Bump the service worker version every release, and add "Check for updates" in Settings.
Open lesson 6 β€Ί
You're on version 12
A new version is ready
7

Make it feel like an app

Small things matter at 3am: buttons big enough for a thumb, nothing hidden under the clock, and pop-ups you can swipe away.

Respect the safe area, make tap targets 44px, and let sheets swipe down to close.
Open lesson 7 β€Ί
Log a feed

Drag the sheet down to close it.

8

Test it before it goes live

Ask the agent to click through the whole app in a real browser, show you screenshots, and only put it live when you say so.

Run the tests and a full click-through, show me screenshots, then ask before deploying.
Open lesson 8 β€Ί
  • Unit tests pass
  • Sign in and out
  • Two phones see each other's entries
  • Works offline, then syncs
  • Screenshots look right
  • You said "yes, put it live"
9

Private by default, public when you want

Start with only you and the people you invite. Open parts up later: a public page, sign-ups, or paid plans. Either way, no tracking people didn't ask for, an export button, and a delete button that really deletes.

Keep it private for now. Add export, and delete everything on request.
Open lesson 9 β€Ί
πŸ”’
Your log

You Β· your partner Β· anyone you invite
Nobody else.

10

A real address

Swap the free workers.dev address for your own name, without breaking the copies people already have on their phones.

Add my domain, keep the old address working, and tell me which DNS records to change.
Open lesson 10 β€Ί
πŸ”’my-app.you.workers.dev

Both addresses keep working while people move over.

11

Tell people about it

A page that explains your app, a preview that looks good when the link is shared, a waitlist, a short honest video, and a way to hear back from the people using it.

Make a page that explains my app, a share preview for links, and a waitlist. Then help me plan a short video.
Open lesson 11 β€Ί
With a share preview
🎹Book a lessonPick a time · get a confirmation
Piano lessons with Samlessons.example
Without
https://lessons.example/

Get the skill

Give your agent the whole course in one file.

A skill is a folder of instructions your agent reads when the job fits. Install this one and it follows these eleven steps for you, including asking before it puts anything live.

idea-to-icon/
  SKILL.md # house rules, the path, key lessons
  references/ # read when the step comes up
    data-and-sync.md
    design-and-ux.md
    domains.md
    getting-online.md
    github-and-deploys.md
    launch-and-growth.md
    phone-features.md
    security-and-privacy.md
    sign-in-and-email.md
    testing.md
    updates-and-pwa.md
--- name: idea-to-icon description: Build and run a real web app with the user, from first mockup to a live address and an icon on their home screen, on Cloudflare … --- # Idea to Icon ## House rules 1. Ask before anything goes live. Every time. 2. Mock up first. 3. Show, don't tell. …
1
Paste this into Claude Code

It downloads the skill into your skills folder for you.

Read https://ideatoicon.app/agents.md and install the Idea to Icon skill.
2
Or run one line yourself

Short enough to read, so you can see exactly what it does.

mkdir -p ~/.claude/skills && curl -fsSL https://ideatoicon.app/skill/idea-to-icon.zip -o /tmp/idea-to-icon.zip && unzip -o /tmp/idea-to-icon.zip -d ~/.claude/skills
3
Ask for an app

Your agent picks the skill up when the job fits, or ask for it by name.

Use the idea-to-icon skill: a tracker for my plant watering

The skill lives at ideatoicon.app/skill, so it's always the latest version. Download the zip if you need it.

House rules the skill follows

Things we learned the hard way.

Ask before going live

Every release. A tired "yes" is fine, silence is not.

Plain words

"Saved" beats "Synced to remote". Write for someone in a hurry, on a phone.

Never invent facts

Health or safety wording comes from a named source, quoted closely.

Real data stays private

Tests use made-up people. Real people's data is never shown anywhere public.

One change, one check

Show a screenshot of each change and open it, so you see what's shipping.

Tidy up

Delete test files and screenshots afterwards.