Tutorials · Beginner
Publish your website free on Vercel in 10 minutes
Connect your GitHub repository to Vercel and get a public URL in minutes. No server setup. Free for personal projects with the Hobby plan.
- Vercel
- GitHub
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 |