Deploy Quickstart
When to Use This Module
Use this guide during Phase 2 (Build) when you have a release candidate ready to ship. It walks through deploying a microproduct using only GitHub and the Vercel free Hobby plan. It works for any static site or Vercel-supported web app — no paid services required.
Prerequisites
- A GitHub account
- A Vercel account on the free Hobby plan
- A microproduct repository that builds successfully on your machine
1. Push to GitHub
Create a new repository on GitHub and push your microproduct code:
git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/<your-username>/<your-repo>.git
git branch -M main
git push -u origin main
If you started from a product template, fork or copy the starter into its own repository first.
2. Import into Vercel
- Sign in to vercel.com with your GitHub account.
- Click Add New… → Project.
- Select Import Git Repository and choose your microproduct repo.
- Grant Vercel access to the repository if prompted.
3. Configure the Build
Vercel auto-detects most frameworks (Next.js, Vite, Astro, Docusaurus, etc.) and fills in the build command and output directory. Review the settings before deploying:
| Setting | Typical value |
|---|---|
| Framework Preset | Auto-detected |
| Build Command | npm run build |
| Output Directory | dist, build, or .next (depends on framework) |
| Install Command | npm install |
If auto-detection does not match your project, add a vercel.json at the repo
root:
{
"buildCommand": "npm run build",
"outputDirectory": "dist"
}
Adjust buildCommand and outputDirectory to match your project.
4. Deploy
Click Deploy. Vercel builds your project and assigns a production URL
(e.g. your-repo.vercel.app). Every push to main triggers an automatic
redeploy.
5. Preview Deployments
Open a pull request on GitHub and Vercel creates a unique preview URL for that
branch. Share the preview link for review before merging to main.
Hobby Plan Limits
The Vercel Hobby plan is free and suitable for personal and non-commercial microproducts. Be aware of these constraints:
- Bandwidth: 100 GB per month
- Build minutes: 6,000 per month
- Serverless execution: 100 GB-hours per month
- Commercial use: Hobby is for personal projects; commercial products need the Pro plan
If your microproduct outgrows these limits, review Vercel's pricing before upgrading.
Next Step
Once deployed, move into Operate to own distribution, learning, and iteration after launch.