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

By Tania Ahmad, freelance Shopify & full-stack developer · Published 2026-11-18 · Updated 2026-11-18
Source: https://www.taniaahmad.site/blog/vibe-code-website-claude-vercel

> **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](https://claude.ai/) 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

- Create a free account at [github.com](https://github.com).

- Click New repository, give it a name (for example `my-website`) and create it.

- Use Add file → Upload files to upload your `index.html` (and any images), then commit.

Prefer working on your computer? [Claude Code](https://www.taniaahmad.site/blog/claude-code-beginners-guide) can create the project folder, build multiple pages and push to GitHub for you.

## Step 4: publish with Vercel

- Sign up at [vercel.com](https://vercel.com) with your GitHub account.

- Click Add New → Project, import your repository and press Deploy.

- 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

- Buy a domain from a registrar (many hosts, such as [Hostinger](https://www.hostinger.com/wordpress-hosting), sell them).

- In Vercel, open your project → Settings → Domains and add it.

- 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](https://pagespeed.web.dev/).

- **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](https://www.taniaahmad.site/web-app-developer)

## 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

- [Vercel pricing and Hobby plan](https://vercel.com/pricing)
- [Vercel fair use guidelines](https://vercel.com/docs/limits/fair-use-guidelines)
- [Claude plans and pricing](https://claude.com/pricing)
