Deployment

Render Deployment (Recommended)

Render is currently the safest production deployment target for Vista apps.

Updated: 2026-03-04

Render is currently the recommended production target for Vista.

If you are launching now, use Render first. This setup is written for end-users deploying a Vista app directly from project root.

render.yaml Blueprint

render.yaml

yaml
services:
  - type: web
    name: my-vista-app
    runtime: node
    region: oregon
    plan: free
    buildCommand: |
      npm install --no-audit --no-fund
      npm run build
    startCommand: npm run start
    envVars:
      - key: NODE_ENV
        value: production
      - key: PORT
        value: 3003
    healthCheckPath: /

Why This Works

  • Uses normal root-level scripts (`npm run build`, `npm run start`).
  • Matches default scripts generated by `create-vista-app`.
  • No internal source-directory commands required.

Troubleshooting

  • If modules are missing, ensure `npm install` runs in the same project root that contains your `package.json`.
  • If CSS build fails, verify `postcss`, `postcss-cli`, and `tailwindcss` are installed and committed in lockfile.
  • If start fails, confirm `build` and `start` scripts exist in your app `package.json`.