Configuration

Config file

Create vela.config.json in your project root:

{
  "app": "my-app-slug",
  "schemasDir": "./vela/schemas"
}

Field	Required	Default	Description
`app`	yes	—	App slug or UUID
`schemasDir`	no	`./vela/schemas`	Directory containing schema JSON files
`clientSecret`	no	—	Client secret. Prefer the env var instead

The VELA_CLIENT_SECRET environment variable takes precedence over the config file:

export VELA_CLIENT_SECRET="vela_cs_..."

Do not commit secrets to vela.config.json. Use environment variables or your CI’s secret store.

All commands accept flags that override the config file:

Flag	Description
`--app <slug>`	Override the app slug/UUID
`--dir <path>`	Override the schemas directory path

vela push --app staging-app --dir ./schemas/staging

Settings are resolved in this order (highest wins):

⌘I