Publish your website free on Vercel in 10 minutes

Vercel turns your GitHub repository into a website with a public URL in under 2 minutes. Every time you push a change, the site updates itself. Free for personal projects. Tap each step to open it.

Before you start: you need a GitHub repository with your project (guide). Works with plain HTML, Astro, React, Next.js and many others.

1 Create your Vercel account

Go to https://vercel.com
Click “Sign Up”.
Choose “Continue with GitHub”, Vercel connects to your account in one click.
Accept the permissions it requests (it needs to read your repositories to import them).

You land straight in the dashboard. No credit card needed for the Hobby plan.

2 Import your project from GitHub

In the dashboard, click “Add New… → Project”.
You’ll see a list of your GitHub repositories. Find yours and click “Import”.

Repository not showing? Click “Adjust GitHub App Permissions →”, grant access to that repository and come back.

3 Configure and deploy

Vercel automatically detects your project type (Astro, React, plain HTML, etc.) and sets everything up. Normally you don’t need to change anything.

Check the “Framework Preset” field: if Vercel detected it correctly, you’ll see the framework name. If your project is plain HTML, it shows “Other”.
If you need environment variables (API keys, etc.), add them under “Environment Variables”. If you don’t know what this is, leave it blank.
Click “Deploy”.

In 1–2 minutes you’ll see progress bars and a celebration screen with your URL.

4 Share and update your site

Your URL looks like your-project-name.vercel.app. Share it with anyone right now.

To update your site: just push changes to GitHub (with Claude Code or from VS Code) and Vercel detects and deploys them in 1–2 minutes. Nothing else to do.

To see deployment history or change settings, go to your project dashboard at https://vercel.com/dashboard.

If something goes wrong

Problem	Fix
I can’t see my repository in the list	Click “Adjust GitHub App Permissions” and grant access to the repository
The deploy fails with errors	Click “View build logs”, copy the error and paste it into Claude Code to fix it
Page loads blank	Check that the main file is named `index.html`, or that the framework is correctly detected
I want a custom domain instead of .vercel.app	See the Connect your own domain guide
Is it always free?	The Hobby plan is free with no time limit for non-commercial personal projects. Confirm terms at https://vercel.com/pricing