All articles

· 9 min read

How I design and ship a landing page with an AI agent

My process, step by step, with real moments from building this portfolio with Claude Code: reusing components, directing with screenshots, keeping the copy human and verifying the details.

A screenshot, one sentence, and the agent updates the live page.

This portfolio was designed and built in a single working session with an AI coding agent (Claude Code), in Next.js and Tailwind. I gave the direction, it wrote the code, and we went back and forth around a hundred times. Here is the process, with the real moments from that session.

The short version: the agent made the building fast. The decisions still took a designer.

1. Agree on the goal and the reader

Same card, two readers. Once the reader was agreed, the mentoring stat had to go.

Before changing anything, I asked the agent a plain question: what is this page for, and who reads it? Its answer: get a 20-minute intro call, ideally leading to a two-week launch sprint, read by founders and CTOs of B2B SaaS companies who need to ship without hiring a front-end team.

That answer became a filter for every section that came after.

2. Reuse what already works

Four components from my course site, copied with their assets, then rewritten for clients.

I already had a course site, LaunchPad, built the same way. Instead of designing from zero, I pointed the agent at components I liked there: the hero with its video and step stack, the about bento, the places carousel, the testimonials bento. It copied them, with their assets, and adapted the copy to the new reader.

Reuse is where most of the speed comes from. A component that already works, with its animations and edge cases solved, is worth more than a new one generated in seconds.

3. Direct with screenshots, one change at a time

One line, four positions, a minute each. The final layout came from seeing each version.

Most of my instructions were a screenshot and one sentence: “put this under the button”, “remove the border of this badge”, “more space between the card and the title”. Small, visual, easy to judge.

Because each change costs seconds, I can try placements I would never bother to mock up. Trying is cheaper than debating.

4. Ask for options, then build two

Four proposals with a recommendation. I picked one and kept another as a second section to compare live.

When I don't know what I want, I ask for options with a recommendation, and I often build two of them side by side on the live page.

Same for effects: for the contact section background, five hover ideas (flashlight, glow, spark trail, ripple, magnetic grid). I picked the ripple: each mouse move sends a ring across the dot grid and lights the dots it crosses.

Want this process applied to your product?

A launch sprint puts your landing page live in two weeks, at a fixed price. I reply within 48 hours.

5. Keep the copy human

The contrast formula goes, a plain fact replaces it.

AI writes fluent copy quickly, and it has tics. The one I can't stand is the contrast formula: “live in weeks, not quarters”. I asked to remove it once, and the agent saved it as a rule for the rest of the session, then flagged the other places where the pattern still appeared.

Rewrite with a plain fact. “A launch sprint goes live in two weeks.”

Testimonials are a special case. I asked the agent to make them as impactful as possible, and it refused to rewrite them: a reworded testimonial is no longer a testimonial. It cut instead, word for word, marked the cuts with […], and highlighted the strongest phrase.

6. Let the agent measure the details

Two bugs my eye caught and the agent explained by measuring: dots 5.5 px off the grid, and corners at 18 px instead of 16.

My eye catches that something is off. The agent finds out why, by measuring the real page in the browser.

7. Placeholders that can't ship by accident

Dashed borders, brackets, grey stars and initials: nobody mistakes this for a real testimonial.

I wanted to see the full structure before I had all the content: several case studies, eight testimonials. The agent filled the gaps with placeholders designed to look unfinished: dashed borders, “[Placeholder]” in brackets, grey stars, initials instead of photos. Nobody could mistake them for real content.

It did the same with facts. When it added company stats to the client logo cards, it told me which numbers came from general knowledge and needed checking before going live.

8. Motion with restraint

Every effect on the page follows the same four rules.

The page has a lot of small motion: decoding button labels, a logo cover flow, a spotlight that dims the page when you hover the main button, a shine that crosses the icons every six seconds. Each one follows the same rules, set once:

  • it only runs when it's on screen;
  • it pauses when you hover it, so you can read;
  • hover effects are for mouse and trackpad, touch gets a simpler version;
  • visitors who ask their system for reduced motion get a still page.

9. Verify, and say what wasn't verified

Checked what could be checked, and said plainly what couldn't.

After each change, the agent ran the type checker and the linter, and when it mattered it tested in the browser: simulating a hover, measuring positions, checking which tab was selected. A scorecard tool I added had its score checked by hand against the formula.

Just as useful: it told me when it couldn't verify something. When my browser tab was in the background, animations were paused, and it said so plainly.

10. What stays with me

Speed from the agent, decisions from the designer.

The agent wrote almost all the code. These decisions were mine, and they are the ones that make the page work:

  • who the page is for, and what it should get them to do;
  • which offers come first, and what each one promises;
  • which testimonials to feature, and which sentences matter;
  • when to stop adding effects;
  • the facts only I know: availability, clients, prices.

That's also what I sell. If you want a landing page built this way, with the judgment and the speed, a launch sprint takes two weeks. Not sure where your current page stands? Start with the free landing page scorecard.

What would you ship in two weeks?

Tell me about the product. I'll reply with the offer that fits, or tell you honestly if none does.