Reference

Vista Config Reference

Reference for `vista.config.ts` including server settings, image config, and experimental typed API flags.

Updated: 2026-03-04

Minimal Config

ts

ts
const config = {};
export default config;

Engine Variant

ts

ts
const config = {
  engine: {
    variant: 'flashpack', // 'default' | 'flashpack'
  },
};

export default config;

Vista CLI reads this setting for vista dev, vista build, and vista start, so generated app scripts do not need engine-specific variants.

Typed API Config

ts

ts
const config = {
  experimental: {
    typedApi: {
      enabled: true,
      serialization: 'json', // 'json' | 'superjson'
      bodySizeLimitBytes: 1024 * 1024,
    },
  },
};

export default config;

Server Port

ts

ts
const config = {
  server: {
    port: 3000,
  },
};

export default config;

Image Domains

ts

ts
const config = {
  images: {
    domains: ['example.com', 'cdn.myapp.com'],
  },
};

export default config;

Deploy Config

ts

ts
const config = {
  deploy: {
    target: 'auto', // 'auto' | 'render' | 'vercel' | 'cloudflare' | 'netlify' | 'docker'
    output: 'standalone', // 'standalone' | 'static' | 'hybrid'
    prod: true,
    preferBuildOutputApi: true,
  },
};

export default config;

Use with npm run deploy or vista deploy. See Vista Deploy Command (/docs/deployment/vista-deploy-command).

Related