Documentation Index
Fetch the complete documentation index at: https://tommy-acf5e428.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
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}"
${UNDEFINED_VAR} stays as-is).