Skip to Content
SDK & PluginsLocal Data

Local Data

Use this page when teammates need personal test data without merge conflicts.

What changes locallyMechanism
scalar config like URLs, IDs, flags.env.local and .env.local.secrets
structured request bodies or example rows*.local.json next to shared data files

Local env files

Keep the team baseline committed and personal overrides gitignored:

.env
.env.secrets
.env.local
.env.local.secrets

Add the personal files to .gitignore and switch to them locally with:

glubean run --env-file .env.local

Local JSON data

For structured examples, keep shared and personal files in the same directory:

data/create-user/
  shared.json
  alice.local.json

With fromDir.merge(), local keys override shared keys. With fromDir() or fromDir.concat(), local rows are appended.

Data mode

GLUBEAN_DATA_MODE lets you load:

  • all data
  • only local files
  • only shared files

This is useful when personal debug data should stay out of CI.

Next

Only my data → GLUBEAN_DATA_MODE=local_only in .env.local (fromDir.* skips shared files entirely)

Only shared (CI) → GLUBEAN_DATA_MODE=shared_only (fromDir.* ignores .local. files)


No test code changes needed. For env files, just switch `--env-file`. For data files, the same `fromDir.*` call reads both shared and local files automatically. `GLUBEAN_DATA_MODE` controls the mix. Each team member's personal data stays out of Git entirely.
Last updated on
Data-DrivenShared State