// VIBE_CODING_WORKSHOP

Vibe Coding with Claude Code

You don't need to be a developer to build a website. Today you'll learn to guide an AI agent that writes the code for you — and deploy it live.

vibe-coding-demo.mp4

An AI agent in your terminal

Claude Code isn't a chatbot. It's an agent that lives in your terminal, reads your entire codebase, writes code, and runs commands — all while you stay in control.

👁️

Reads your codebase

It sees every file, understands the structure, and knows what already exists before writing anything new.

✍️

Writes code

Creates files, edits existing ones, builds components — from a single function to an entire page.

Runs commands

Installs dependencies, starts dev servers, runs builds, deploys — anything you'd type in a terminal.

Think of it like pair programming with a very fast junior developer. You guide, it executes.

The interface

claude

$ claude

Welcome back. What can I help you with?

> Create a hero section with a gradient background and a tagline

I'll create a hero section. Let me...

Write src/components/Hero.astro

Edit src/pages/index.astro

[Accept] [Reject]

01

You type in plain English

No syntax to learn. Describe what you want and Claude figures out how to build it.

02

It shows you what it'll do

Before changing anything, Claude shows you exactly which files it will create or edit. You approve or reject every change.

03

CLAUDE.md = its memory

A file in your project that tells Claude about your codebase, your preferences, and how you want things done. The more context, the better the output.

The art of vibe coding

Vibe coding isn't about writing code. It's about communicating clearly with an AI that writes code for you. Here's how to do it well:

01

Be specific, not vague

Vague

"Make it look nice"

Specific

"Add a hero section with a dark gradient background, white heading text, and a blue CTA button"

02

Start small, iterate fast

Don't try to build everything in one prompt. Start with structure, then add styling, then polish. Small steps = better results.

03

Read what it writes

Don't just accept blindly. Scan the changes. You'll catch mistakes early and learn how the code works as you go.

04

Reset when it gets confused

If Claude starts going in circles or the output gets weird, start a fresh conversation. A clean context window fixes most problems.

05

Commit often

Every time something works, commit it. Git commits are your save points. If things break, you can always go back.

What we're building today

We're going to build a personal website from scratch using Astro + MDX, deploy it live to the internet — all in under an hour.

Scaffold a new Astro project
Create pages and components with Claude Code
Write blog posts with MDX
Style it with your own design
Deploy to the live internet
yourname.pages.dev

From your laptop to the internet

When you hit "deploy", your code takes a journey through three stops. Understanding this pipeline is the difference between magic and confusion.

💻

Your computer

You write code (or Claude does). Files live in a folder on your machine. You preview at localhost:4321.

src/pages/index.astro src/components/Hero.astro src/styles/global.css
git push
📦

GitHub

Your code gets stored in a repository — a shared folder in the cloud. Every change is tracked. You can always go back.

main branch 3 commits
auto-deploy
🌐

Cloudflare Pages

Cloudflare sees the new code, builds your site, and puts it on servers worldwide. Anyone with the URL can see it.

yourname.pages.dev Live

You only touch step 1. Push your code and the rest happens automatically. That's the magic of continuous deployment — every push becomes a live update.

Let's build it together

Now I'll open the terminal and we'll build this from scratch, live. Watch how I talk to Claude Code, what prompts I use, and how I iterate when things don't come out right the first time.

~/my-site

$ claude

Welcome back. What can I help you with?

> Let's build a personal website...

Want to bring vibe coding to your team?

We run hands-on workshops that get your team building with AI in a single session.