Building a website with Claude Code

The foundation for building real software with AI.
No coding required.

Build with AI. Don't look like it.

Example site: a designer portfolio with a full-bleed photo and serif logotype. Example site built with the tools in this class. Example site built with the tools in this class. Example site built with the tools in this class.
1 / Today
What we're doing today

A live website on a real URL by the end of class.

Your tools are already installed and logged in from the prereqs — today we connect them and build. Here's the machine we're driving:

You talk
Claude edits
GitHub saves
Vercel publishes
🧰

Not set up yet? Open the prereqs deck (prereqs.html) and run through it first — VS Code + Claude Code, the tool installs and logins, your review agents, and your GitHub + Vercel accounts.

1.5 / Scope
Setting expectations

What this class is not.

1.6 / Mentality
The one shift that makes this click

Stop using a tool. Start delegating to a person.

You're not learning a program. You're describing what you want to someone who'll go build it.
The old habit
  • Type keywords and scroll the results.
  • Point and click every step yourself.
  • Ask "how do I do X?" and go do it.
  • Learn the app before you can use it.
Talking to Claude
  • Say in plain English what you want.
  • Describe the goal — let Claude handle the steps.
  • Say "do X for me" — and it does it.
  • No app to learn. You already know how to talk.

It even works before you know exactly what you want. "I want to build a site for my pottery studio — can you help me figure out what it should have?" Claude takes the rough vision, asks a few questions, and brings it down to earth as something real to build.

2 / Working with Claude
Two habits that make every session better

Use Opus, and start fresh often.

Model · Use Opus for coding

Opus is the strongest model for building. Type /model and pick Opus, or use the picker at the bottom of the Claude panel. If your answers feel weak, check you're on Opus.

Sessions · Start fresh between tasks

When you finish one thing and move to the next, click the starburst to open a new session. A clean slate gives sharper results — and uses less of your plan than a long, cluttered chat. (Avoid /clear — it wipes your history.)

Rule of thumb: one focused task per session. Locked the aesthetic? New session. Moving from layout to copy? New session. A short, on-topic conversation always beats a giant one.

2.5 / Git words
The conceptual heart of the class

The six words you need to know.

We're skipping branching for now — it comes up once, at the very end.

2.6 / Create your repo
Connect the three

Create your repo — and wire it to GitHub and Vercel.

The prereqs logged you into everything, but your project isn't connected to anything yet — without this step, Claude won't know where to push. Ask Claude in the VS Code terminal:

Create a GitHub repo for this project and connect it to my Vercel. Make sure they're synced and a push will deploy.

Verification checklist

3 / The critical rule
When does the world see your changes?

Local = practice. Push = publish.

Local (your computer)

Every edit shows up the moment you save. Preview it in your browser anytime. Experiment, break things, undo, redo — nobody sees it.

Push (to GitHub)

The moment you push, Vercel rebuilds and the changes go live for the whole internet. Only push when you're ready.

This is the single most important concept of the day. Build locally. Push when proud.

4 / Impeccable
Make it look good

Claude codes it. Impeccable makes it beautiful.

Skipped the prereqs, or not sure it's there? Paste this and Claude sorts it out:

Check whether Impeccable is installed globally, and if it isn't, install it globally from impeccable.style using npx. If it asks "project or global?", choose global.

Trouble installing? More options at impeccable.style/#downloads

5 / Design brief
Give it the context it needs

The single most important slide of the day.

Run /impeccable init to start. In the same message, paste in as much context as you can — these are blank repos with zero info about your business.

Include in your first message

Logo tip: drop your logo file into the root of the project tree before running — it gets picked up automatically.

At the end of /impeccable init, it offers to run /impeccable documentsay yes. It writes two files every command reads first: PRODUCT.md (who, what, why) and DESIGN.md (colors, type, components).

6 / How to review
Big picture down to small

Review and iterate from the outside in.

After every /impeccable pass, fight the urge to fix small things first. Lock each layer before moving down — otherwise you'll polish a button that's about to get deleted anyway.

TIP

Once a layer feels done, click the starburst to open a new session. A clean slate gives better results and uses less of your plan.

Top of funnel
Detail
1. Aesthetic / vibe — Does it feel like the brand? Don't read words. Squint. (Whole site.)
2. Sections / Information Architecture — Right sections in the right order? (Whole site.)
3. Layout within each section — Hierarchy and balance. (One section at a time.)
4. Copy — Does it sound like you? Is it clear? (Section by section.)
5. Details / craft — Micro-interactions, spacing, polish.

You can use the iteration commands at every layer/impeccable bolder, animate, delight, etc. all work whether you're fixing the whole-site aesthetic or just one section's layout. Full list on the next slide.

And: describe what's wrong — don't try to micro-direct the fix. "The CTA feels lost" beats "move the button 4px left."

6 / The build loop
How you get from rough to right

The first pass is never right. That's the point.

The first build just gets your site on the screen — rough and plain is expected. Here's the loop that takes it from there:

Most important — it's a living site. The real refinement starts once it's up: that's when you find what's working, what's noise, what's missing. You keep reshaping it as your business grows — it's never "done."

7 / Iteration commands
Push it further

The commands you'll use at every layer of the funnel.

/impeccable + <command> + whatever you want to work on

Inverse if needed: ask for "quieter" or "calmer" if it goes too far.

→ Full command reference (impeccable.style/docs)

The loop: review (previous slide) → run an iteration command → review again → repeat until you love it.

7 / When things go wrong
Normalizing the chaos

Things will break. That's normal.

When in doubt, describe what you see and what you expected. Claude will figure it out.

7 / Troubleshooting cheat sheet
Save this

When stuck, paste one of these.

PREVIEW Preview won't load:

My local preview won't load. Launch a local server and open it in my web browser.

DEPLOY Vercel build failed:

My Vercel deploy failed. Check the latest deployment logs and fix whatever broke.

UNDO I broke something:

Revert to the last commit.

STALE Claude keeps giving you outdated instructions or APIs that don't exist anymore:

Base your answer on current information — search the internet for the latest docs before responding.
8 / Command sequence
The right order matters

Once layout + aesthetic are locked, here's the order.

→ Full Impeccable docs (impeccable.style/docs)

Creative pass
  • 1. Craft the layout and visual feel with /craft — use this for the initial site and for any new page you add later.
  • 2. Push further with /bolder, /overdrive, /animate, /delight until you love it.
  • 3. Copy last — talk Claude through the copy directly (no special command). Don't waste good copy on a layout you're going to throw away.
Technical pass
  • 4. Optimize + harden/impeccable optimize for accessibility, performance, and code quality, then /impeccable harden to lock down security and resilience.
  • 5. Audit + critique/audit for implementation quality, then /critique for design quality (optional if you're happy). Only after passing do you move to polish.
  • 6. Polish — always last, right before launch.
Step 7 — Ship it Commit + Push → LIVE 🚀
9 / What you can do next week
Build the rest of your site

The pages almost every website needs.

Standard pages

  • Home
  • About — your story, your why
  • Services / Products / What you do
  • Contact — form or email
  • FAQ
  • Testimonials / Social proof
  • Privacy Policy + Terms

Specialized — depends on your business

  • Restaurant → Menu, Reservations, Hours
  • Photographer → Portfolio, Pricing, Booking
  • Consultant → Case Studies, Process, Book a Call
  • Coach → Programs, Free Resources, Schedule
  • SaaS → Features, Pricing, Docs, Changelog
  • Local service → Service Area, Before/After, Reviews
9 / Competitor inspiration
Steal the page list

Look at what competitors have. Their nav bar is your starting page list.

Look at [competitor URL]. What pages does their site have? Suggest which ones make sense for my business.

Then for each page, the prompt is just:

Add a [page name] page. Here's what should be on it: [your notes].
10 / When you're done
Treat it like a real launched site

Two things to do once your site is good enough to share.

Step 1

Get a real domain.

yoursite.com instead of yoursite.vercel.app. ~$12/year.

Buy it inside Vercel: Project → Settings → Domains → "Buy a domain." Vercel handles the DNS setup automatically.

Already own a domain elsewhere? Go to Domains → "Add existing" and Vercel walks you through connecting it.

Step 2

Set up a backup branch.

So you can save work-in-progress to GitHub without it going live.

Right now every push deploys. That was fine while you were building — nobody was looking. Once your site is live and shared, you need a way to back up changes without publishing them.

What's a branch? Think of it as a parallel copy of your project. Vercel only watches the main branch — push to main, it deploys. Push to any other branch, it just sits safely on GitHub. A backup branch is your "saved but not published" lane.

You don't need to memorize git commands — Claude does all the branch switching. Just say:

Set up a backup branch so I can save work-in-progress without deploying. From now on, when I say 'back this up', push to the backup branch. When I say 'ship it', push to main.
11 / Where to go next
After you ship

The next class, if you want it.

End of Class 1

Now go build something.

Then keep going

Let's stay connected.

Email me
eric@stratengineai.com
StratEngineAI

A website is step one. The business is the hard part.

I built StratEngine for exactly that: a tool that thinks through strategy and growth with you, the way a co-founder would.

Check it out → Book a chat →