alepha@docs:~/docs/guides/production$
cat 1-overview.md
2 min read
Last commit:

#Deployment

You've built your app. Now you need to put it somewhere.

Alepha compiles to a standard Node.js application, but we optimize the output for different deployment targets. Same code, different runtimes. You write once, deploy anywhere.

#The Build Command

npx alepha build

This single command does a lot:

  1. Compiles your TypeScript backend.
  2. Bundles your React frontend with Vite.
  3. Optimizes and minifies assets.
  4. Outputs everything to dist/.

Add flags to target specific platforms:

npx alepha build --vercel      # Vercel serverless
npx alepha build --cloudflare  # Cloudflare Workers
npx alepha build --docker      # Docker container
npx alepha build --stats       # Show bundle analysis

#Choosing a Platform

Target Command Best For
Docker --docker Full control, any hosting
Vercel --vercel Easiest deployment, great DX
Cloudflare --cloudflare Edge performance, global reach

Pick based on your needs:

  • "I want the easiest path" → Vercel
  • "I need edge performance" → Cloudflare Workers
  • "I want full control" → Docker on any VPS

Your Alepha code stays the same. Only the deployment target changes.

#Next Steps

On This Page
No headings found...
ready
mainTypeScript
UTF-8guides_production_overview.md