Project Configuration

Getting Started

Every émémá project contains a emema.config.yaml file at the root that controls build and deployment settings.

# Basic configuration example
project:
  name: my-project
  region: us-east-1

build:
  command: npm run build
  dir: ./dist
  platform: nodejs18

npm run configure

Start the interactive configuration wizard

Project name for display and internal reference

Target deployment region (us-east-1, eu-west-1, etc)

Environment mode (dev, staging, production)

Build script command (npm run build, yarn build, etc)

Directory containing build artifacts

Target runtime platform (nodejs18, python3, go119, etc)

Max number of parallel build processes (1-100)

Maximum build duration in minutes (5-60)

Enable automatic capacity scaling

You can define environment variables directly in your configuration file or via our dashboard.

env:
  database_url: "prod.db.example.com"
  API_KEY: ${EMEMA_API_KEY}

EMEMA_API_KEY=secret-value

Set environment variables in dashboard or .env file

Use the CLI to validate and manage your project configuration.

# Validate configuration
emema config:validate

# Show current configuration
emema config:show

# Edit configuration
emema config:edit

emema config:import .env

Import environment variables from file