← Home

Test Data Is Production Configuration

Sep 24, 2026

Many integration tests “pass” because their fixture contains an accidental superuser, an account with every feature enabled, and a timestamp far from any boundary. The test data did not merely set up a test. It chose the product configuration under which the code is allowed to work.

That makes fixtures part of the system's operational specification.

Name the state the test needs

Instead of a generic userFixture(), prefer data that exposes the relevant premise:

const suspendedTenant = await createTenant({ status: 'suspended' });
const viewer = await createUser({ tenantId: suspendedTenant.id, role: 'viewer' });

Now a failing test tells a reader which state transition or permission was expected. A blob of defaults makes the same test dependent on whatever the factory happened to choose this month.

Seed data for demos and staging deserves similar discipline. If a release check assumes an account has an expired card or a pending invitation, keep that state reproducible and versioned. A hand-edited shared environment may be useful for exploration, but it is not a reliable release dependency.

Include the awkward representatives

Healthy, populated records are necessary. So are an empty account, a long-lived account with historical data, a non-default time zone, a tenant at its limit, and a user with the least privilege that should succeed. The point is not exhaustive combinatorics. It is choosing examples that exercise the product distinctions real users encounter.

References

Final take

When a test's outcome depends on state, that state is configuration. Give it a name, a lifecycle, and review equal to the code that consumes it.

Changelog