TANIA.AHMAD Hire me
AIWeb developmentClaudeBeginner guide

Vibe Code Your First Website with Claude and Put It Online with GitHub and Vercel

By , freelance Shopify & full-stack developer · Published · 8 min read

Quick answer

Ask Claude to write a single-page website (HTML and CSS, or React) from a clear brief, preview it in the chat, then save the files to a GitHub repository and import it into Vercel, which publishes it on a free URL in about a minute. Connect your own domain in Vercel's settings. Vercel's free Hobby plan is meant for personal projects, so use a paid plan or another host for a business site.

If you want a personal site, a portfolio or a simple landing page, you can go from idea to a live URL in an afternoon with Claude, GitHub and Vercel. No local setup is required for the simplest version.

Step 1: write a clear brief

AI builds what you describe. A vague prompt gets a generic site; a specific brief gets something that feels like yours.

Build a one-page website for [name / business].
Goal: [e.g. get people to book a call / show my portfolio].
Audience: [who visits].
Sections in order: hero (headline + one button), about, 3 services/projects, testimonials (I'll add real ones), FAQ, contact.
Style: [2–3 colours as hex], [fonts], [mood: e.g. minimal, bold, warm].
Tech: a single index.html with embedded CSS and minimal JavaScript, mobile-first, accessible (good contrast, alt text, labels), fast.
Use placeholder text in [brackets] where you need my real details.

In the Claude chat you'll usually get a live preview of the page you can click through. Ask for changes in plain English until you like it.

Step 2: refine like a designer

  • Be specific: "increase the hero headline size on desktop only", "the buttons need more contrast", "make the services cards equal height".
  • Check mobile: ask Claude to "review the layout at 375px wide and fix anything cramped".
  • Replace every [placeholder] with your real details. Delete anything AI invented, such as fake testimonials.
  • When it's done, download or copy the final index.html.

Step 3: put the files on GitHub

  1. Create a free account at github.com.
  2. Click New repository, give it a name (for example my-website) and create it.
  3. Use Add file → Upload files to upload your index.html (and any images), then commit.

Prefer working on your computer? Claude Code can create the project folder, build multiple pages and push to GitHub for you.

Step 4: publish with Vercel

  1. Sign up at vercel.com with your GitHub account.
  2. Click Add New → Project, import your repository and press Deploy.
  3. In about a minute you get a live .vercel.app URL. Every time you update the files on GitHub, Vercel redeploys automatically.

Important: Vercel's free Hobby plan is intended for personal, non-commercial projects. For a business website, use Vercel's paid plan or another host that allows commercial use on its plan.

Step 5: connect your own domain

  1. Buy a domain from a registrar (many hosts, such as Hostinger, sell them).
  2. In Vercel, open your project → Settings → Domains and add it.
  3. Copy the DNS records Vercel shows you into your registrar's DNS settings. HTTPS is set up for you.

Step 6: the bits beginners forget

  • Contact form: a static page can't send email on its own. Use a form service and ask Claude to wire it in.
  • SEO basics: ask Claude for a unique page title, meta description, Open Graph image tags and a favicon.
  • Analytics: add a privacy-friendly analytics tool, and a cookie notice if you use tracking in the UK/EU.
  • Speed: compress images (WebP), and check with PageSpeed Insights.
  • Accessibility: headings in order, alt text on images, labels on form fields.

When a one-page site isn't enough

Once you need logins, bookings, payments, a dashboard or a database, you're building a web app rather than a website. That's where planning, security and testing matter a lot more, and where a developer saves you time and risk.

Need a site or web app that's built to last?

I build fast websites and full web apps (React, Node, PostgreSQL) for businesses in the UK, US, Canada and Europe. Free discovery call, fixed quote.

See web app services

FAQ

Can I build a website with Claude for free?

Yes for a personal site: the free Claude plan can write a one-page site, and GitHub and Vercel's Hobby plan are free for personal projects. You'll pay for a custom domain, and a business site needs a host plan that allows commercial use.

Do I need to know HTML?

No, but learning to read it a little helps you spot problems and ask better questions. Ask Claude to explain any part of the code you don't understand.

How do I update my site later?

Edit the file (or ask Claude for the change), upload the new version to GitHub, and Vercel redeploys automatically.

Sources

More guides

Got a project in mind?

Tell me what you're building. I reply within one working day with questions or a fixed quote.