Fork-of-Basehealth

Deploying BaseHealth to www.basehealth.xyz

This guide will help you deploy the BaseHealth application to your custom domain www.basehealth.xyz.

Use our automated deployment script:

./scripts/deploy.sh

Manual Deployment Steps

Prerequisites

  1. A Vercel account (https://vercel.com) - Free tier is sufficient
  2. Domain DNS access for basehealth.xyz
  3. Vercel CLI installed: npm i -g vercel
  4. The BaseHealth codebase pushed to GitHub

1. Initial Setup

First, ensure your code is on GitHub:

git add .
git commit -m "Prepare for www.basehealth.xyz deployment"
git push origin main

2. Deploy to Vercel

# Install dependencies
pnpm install

# Login to Vercel (first time only)
vercel login

# Deploy to production
vercel --prod

3. Configure Custom Domain

  1. In Vercel Dashboard:
    • Go to your project settings
    • Navigate to “Domains” section
    • Add both domains:
      • basehealth.xyz
      • www.basehealth.xyz
  2. Configure DNS Settings:

    In your domain registrar’s DNS settings, add these records:

    Type: A
    Name: @
    Value: 76.76.19.61
    TTL: 3600
    
    Type: CNAME
    Name: www
    Value: cname.vercel-dns.com
    TTL: 3600
    

    Note: Vercel will provide the exact IP and CNAME values in your dashboard

4. SSL Certificate & Final Steps

Environment Variables (Optional)

If your app requires environment variables:

  1. Go to Vercel Project Settings
  2. Navigate to “Environment Variables”
  3. Add any required variables:
    • NEXT_PUBLIC_API_URL
    • Database credentials (if applicable)
    • Third-party API keys

Automatic Deployments

Already configured! Every push to the main branch will trigger a new deployment.

Domain Configuration Features

Our setup includes:

Troubleshooting

Common Issues:

  1. DNS not propagating:
    • Wait up to 24 hours
    • Use dig command: dig www.basehealth.xyz
  2. Build errors:
    • Check Vercel function logs
    • Verify environment variables
    • Test build locally: pnpm build
  3. Domain not working:
    • Verify DNS records match Vercel’s requirements
    • Check domain status in Vercel dashboard

Verification Commands:

# Check DNS propagation
nslookup www.basehealth.xyz

# Test local build
pnpm build && pnpm start

# Check Vercel deployment status
vercel ls

Professional Email Setup

Consider setting up professional email addresses:

Recommended services:

Monitoring & Analytics

After deployment, consider adding:

🎉 Your BaseHealth platform will be live at https://www.basehealth.xyz!

For support, check the Vercel documentation or create an issue in this repository.


Made with ❤️ for BaseHealth