Skip to content

Environments

Environments give every namespace a test and a live environment, with separate keys, records and money over one shared definition.

Environments give every Startup two worlds, test and live, over one shared definition. The key on each call picks the world, and records, money and Messages never cross between them.

Contract

Both environments run the same Nouns, Offers, Pages and code. Every operational record, such as an Order or an Event, belongs to exactly one environment.

Ruletestlive
Key prefixsk_test_sk_live_
Build it runsThe head: the latest merged ChangeThe Version last deployed
MoneyTest payments: test cards, no funds moveReal charges, refunds and payouts
Outbound MessagesDelivered only to the Startup's own addresses and numbersDelivered under Consent and Suppression
Outside effectsDomain purchases, ad spend and filings are simulated, then recorded as donePerformed
Before the first deployServes every VerbReturns not-live, status 503

Permissions, Limits, Approvals and delay windows behave the same in both, so a flow that passes in test passes in live. New keys default to test. Experiments run only in live, behind Flags.

The environments guide walks through keys and going live.

Verbs

Interfaces

Example

An Agent builds quillnote.app, a résumé critique sold per review, entirely in test and sells to test Customers on test cards. When the founder deploys Version 3, live starts serving, and the test Orders stay in test.