Configuration

Config file reference for seedling.yaml.

Configuration File

All CLI flags can be expressed as a YAML config file. Supports ${ENV_VAR} interpolation.

File Location

By default, Seedling looks for seedling.yaml in the current directory. Use --config to specify a different path:

seedling generate --config ./configs/staging.yaml

Full Reference

database:
  dsn: "${DATABASE_URL}"

output:
  format: sql
  file: seed.sql
  batch_size: 1000
  use_copy: true

generation:
  count: 50000
  seed: 42
  verbose: true
  parallel: false

schema:
  file: schema.yaml

generators:
  file: overrides.yaml

Sections

database

Field	Description	Example
dsn	Database connection string	postgres://user:pass@localhost:5432/mydb

output

Field	Description	Default
format	Output format (sql, csv, jsonl, parquet)	sql
file	Output file path	seed.sql
batch_size	Rows per batch	1000
use_copy	Use Postgres COPY protocol	false

generation

Field	Description	Default
count	Rows per root table	100
seed	Deterministic seed (0 = random)	0
verbose	Progress bars and summary	false
parallel	Generate tables in parallel	false

schema

Field	Description	Default
file	Schema file path	schema.yaml

generators

Field	Description
file	Generator overrides YAML file

Environment Variable Interpolation

database:
  dsn: "${DATABASE_URL}"

generation:
  seed: "${SEEDLING_SEED}"

Variables that are not set remain as literal strings (e.g., ${UNDEFINED_VAR} stays as-is).