GuidesConfiguration

Configuration

Learn how to configure your Lizard project.

Config File

Lizard uses a lizard.config.ts file at the root of your project:

import { defineConfig } from 'lizard';
 
export default defineConfig({
  name: 'my-project',
  region: 'us-east-1',
  runtime: 'node20',
  build: {
    command: 'npm run build',
    output: 'dist',
  },
});

Configuration Options

OptionTypeDefaultDescription
namestringProject name (must be unique)
regionstringus-east-1Primary deployment region
runtimestringnode20Runtime environment
build.commandstringnpm run buildBuild command
build.outputstringdistBuild output directory

Regions

Lizard supports the following regions:

  • us-east-1 — US East (Virginia)
  • us-west-2 — US West (Oregon)
  • eu-west-1 — Europe (Ireland)
  • ap-southeast-1 — Asia Pacific (Singapore)

Multi-Region

Deploy to multiple regions for lower latency:

export default defineConfig({
  name: 'my-project',
  regions: ['us-east-1', 'eu-west-1', 'ap-southeast-1'],
  routing: 'latency-based',
});