Vercel CLI

Manage FuzzyCat's Vercel deployments. The CLI is installed at ~/.bun/bin/vercel and already authenticated.

Common Commands

Deployments

bash
1# List recent deployments
2vercel ls
3
4# Get latest deployment URL
5vercel ls --json 2>/dev/null | python3 -c "
6import sys,json
7deploys=json.load(sys.stdin)
8if deploys: print(f\"{deploys[0]['url']} | {deploys[0]['state']} | {deploys[0]['createdAt']}\")"
9
10# Get deployment details
11vercel inspect <deployment-url>
12
13# View deployment logs
14vercel logs <deployment-url>
15
16# View real-time logs (streaming)
17vercel logs <deployment-url> --follow

Environment Variables

bash
1# List all env vars
2vercel env ls
3
4# List env vars for specific environment
5vercel env ls --environment production
6
7# Pull env vars to a file
8vercel env pull /tmp/prod-env.txt --environment production
9
10# Add an env var (all environments)
11vercel env add VAR_NAME
12
13# Add env var for specific environment
14vercel env add VAR_NAME production
15
16# Remove an env var
17vercel env rm VAR_NAME

Domains

bash
1# List domains
2vercel domains ls
3
4# Inspect domain
5vercel domains inspect fuzzycatapp.com
6
7# Add a domain
8vercel domains add subdomain.fuzzycatapp.com

Projects

bash
1# Project info
2vercel project ls
3
4# Link current directory to project
5vercel link

Manual Deployment

bash
1# Deploy to preview
2vercel
3
4# Deploy to production (prefer auto-deploy via git push)
5vercel --prod
6
7# Note: Auto-deploys from GitHub are the standard workflow.
8# Manual vercel --prod should be avoided unless auto-deploys are broken.

Debugging

bash
1# Check build output
2vercel logs <url> --output json 2>/dev/null | python3 -c "
3import sys,json
4for line in sys.stdin:
5    try:
6        entry = json.loads(line)
7        if entry.get('type') == 'error':
8            print(f\"ERROR: {entry.get('text','')}\")
9    except: pass"
10
11# Check function logs (serverless)
12vercel logs <url> --follow
13
14# Check if deployment is healthy
15curl -sL https://www.fuzzycatapp.com/api/health | python3 -m json.tool

Production Checks

bash
1# Quick health check
2curl -sL https://www.fuzzycatapp.com/api/health | jq .status
3
4# Check API v1
5curl -sL https://www.fuzzycatapp.com/api/v1/health | python3 -m json.tool
6
7# Check deployment status
8vercel ls 2>/dev/null | head -5

FuzzyCat-Specific

• Project: fuzzy-cat-apps-projects/fuzzycat
• Production URL: https://www.fuzzycatapp.com
• Framework: Next.js (auto-detected by Vercel)
• Build command: next build (Vercel default)
• Preview deploys: Currently disabled via vercel.json ignoreCommand
• Auto-deploys: Triggered by pushes to main branch on GitHub
• Environments: Development, Preview, Production (each with separate env vars)