Cloud Deployment

Supported Providers

AWS (Amazon Web Services)

• Tools:

  awsDeployS3Site

  ,

  awsCreateLightsail

  ,

  awsDeployAmplify

  ,

  awsManageRoute53

  ,

  awsConfigureCloudFront

  ,

  awsConfigureLambda

• Best for: Production-scale apps, enterprise, anything needing full infrastructure control
• Secrets:

  aws.accessKeyId

  ,

  aws.secretAccessKey

• Patterns:
  • Static sites: S3 + CloudFront CDN
  • Full-stack: Amplify (Git-based) or Lightsail instances
  • Serverless: Lambda functions
  • DNS: Route53 for domain management

Vercel

• Tools:

  vercelDeploy

  ,

  vercelManageDomains

  ,

  vercelGetDeployment

• Best for: Next.js, React, frontend frameworks; instant preview deployments
• Secrets:

  vercel.token

• Patterns:
  • Git push triggers automatic deploy
  • Preview URLs for every PR
  • Serverless functions at edge locations
  • Automatic HTTPS and CDN

Netlify

• Tools:

  netlifyDeploy

  ,

  netlifyManageDomains

  ,

  netlifyGetSite

• Best for: JAMstack, static sites, form handling, split testing
• Secrets:

  netlify.token

• Patterns:
  • Drag-and-drop or Git-based deploys
  • Built-in forms and identity management
  • Branch deploys and A/B testing
  • Netlify Functions (AWS Lambda under the hood)

Railway

• Tools:

  railwayDeploy

  ,

  railwayManageServices

• Best for: Full-stack apps with databases, quick prototyping, monorepo support
• Secrets:

  railway.token

• Patterns:
  • Nixpacks auto-detection (no Dockerfile needed)
  • Managed Postgres, Redis, MySQL included
  • Per-service scaling
  • Sleep mode for dev environments (cost savings)

Fly.io

• Tools:

  flyDeploy

  ,

  flyManageMachines

  ,

  flyManageSecrets

• Best for: Global edge deployment, Docker containers, distributed apps
• Secrets:

  flyio.token

• Patterns:
  • Deploy Docker containers to 30+ global regions
  • Machines API for fine-grained control
  • Built-in Postgres, Redis, and LiteFS
  • Auto-scaling to zero

Heroku

• Tools:

  herokuDeploy

  ,

  herokuManageApps

  ,

  herokuManageAddons

• Best for: Quick prototypes, add-on marketplace, developer experience
• Secrets:

  heroku.apiKey

• Patterns:
  • Buildpack auto-detection
  • Rich add-on marketplace (databases, monitoring, caching)
  • Pipeline-based CI/CD with review apps
  • Dyno-based scaling

DigitalOcean

• Tools:

  doCreateDroplet

  ,

  doDeployApp

  ,

  doManageDns

• Best for: Simple VPS needs, Kubernetes, managed databases
• Secrets:

  digitalocean.token

• Patterns:
  • Droplets for VPS needs
  • App Platform for PaaS experience
  • Managed Kubernetes (DOKS)
  • Spaces for object storage

Linode (Akamai)

• Tools:

  linodeDeploy

  ,

  linodeManageInstances

• Best for: Affordable VPS, high-performance compute, data sovereignty
• Secrets:

  linode.token

• Patterns:
  • Linodes for VPS (competitive pricing)
  • NodeBalancers for load balancing
  • Block and Object Storage
  • Kubernetes (LKE)

Cloudflare Pages

• Tools:

  cloudflareDeploy

  ,

  cloudflareManageDns

  ,

  cloudflareManageWorkers

• Best for: Edge-first deployment, Workers for serverless, DNS/CDN, DDoS protection
• Secrets:

  cloudflare.apiToken

• Patterns:
  • Pages for static + SSR frameworks
  • Workers for serverless at edge (200+ cities)
  • R2 for S3-compatible object storage (no egress fees)
  • D1 for edge SQLite databases

Provider Selection Decision Tree

1. What are you deploying?
   • Static site/SPA → Vercel, Netlify, Cloudflare Pages, or S3+CloudFront
   • Next.js/React → Vercel (first choice), Netlify, Cloudflare Pages
   • Docker containers → Fly.io, Railway, DigitalOcean, AWS
   • Full-stack with database → Railway, Fly.io, Heroku, AWS
   • Serverless functions → Cloudflare Workers, AWS Lambda, Vercel
2. What is the budget?
   • Free tier / hobby → Vercel, Netlify, Cloudflare Pages (generous free tiers)
   • Affordable VPS → Linode ($5/mo), DigitalOcean ($4/mo)
   • Cost-optimized production → Cloudflare (no egress), Railway (usage-based)
   • Enterprise / no budget limit → AWS (most features, most complex)
3. What is the scale?
   • Prototype / MVP → Railway, Heroku, Vercel
   • Small-medium production → Fly.io, Vercel, Netlify
   • Large-scale / global → AWS, Cloudflare, Fly.io
4. Special requirements?
   • Global edge presence → Cloudflare, Fly.io, Vercel
   • Self-managed infrastructure → AWS, DigitalOcean, Linode
   • Managed databases included → Railway, Fly.io, Heroku
   • Data sovereignty / specific region → Linode, DigitalOcean, AWS

Deployment Workflow

1. Build — Ensure the project builds locally (

   npm run build

   ,

   docker build

   , etc.)
2. Configure secrets — Store provider API keys in

   credential-vault

3. Deploy — Use the appropriate provider tool
4. DNS — Point domain using provider DNS tools or external registrar
5. Verify — Check deployment URL and run health checks
6. Monitor — Set up logging and alerting through provider dashboard

Cost Comparison (approximate monthly, small app)