--- title: "Test and live" url: https://services.dev/docs/operate/testing captured: [operate-test.txt] --- # Test and live URL: https://services.dev/docs/operate/testing > Every brand runs in two modes at one address, and the key picks the mode, with the same simulation on your machine before either. Test mode simulates AI, money, outside systems and members, takes magic values that pick each branch, and runs on test clocks, so a whole season runs before a buyer sees it. Every key runs in test on every plan. Test mode answers one question: does every branch of the Service work before anything real happens? A brand serves both modes at the same address. An `sk_test_` key reaches test mode and an `sk_live_` key reaches live, and no job, member, subject or dollar ever crosses between them. ## What each mode does | | On your machine | Test mode | Live | |---|---|---|---| | Version | your folder as it stands, reloaded on save | the newest [tested](https://services.dev/docs/operate/deploy.md) version | the version `deploy --live` promoted | | Served by | `services.dev dev`, at `localhost:8787` | your brand's address, to `sk_test_` keys | your brand's address, to `sk_live_` keys | | AI | simulated | simulated, unless you set `--model live` on a test key | your model key, at cost | | Money | recorded, never moved, and no Stripe | recorded on the ledger, never moved | charged, released, refunded and paid out on your Stripe account | | Outside systems | the sandbox, steered by [magic values](https://services.dev/docs/reference/magic-values.md) | the same sandbox | the real endpoint and its receipt | | Members | the [simulated market](https://services.dev/docs/people/pool/simulate.md) | the simulated market, and your staff | the people in your Pool | | Time | your clock, or a test clock | the brand's clock, or a test clock you advance | the brand's clock | | Every answer | carries `simulated: true` | carries `simulated: true` | carries `simulated: false` | | Plan | every key, on every plan | every key, on every plan | each key on [the plan that carries it](https://services.dev/docs/money/plans.md) | ## Where each mode serves | Deploy | Serves at | Plan | |---|---|---| | test and live | `.builder.domains` | every plan | | your own domain | `Brand.domain`, with its certificate renewed for you | Launch | | a preview of a branch | `services.dev preview`, on test keys, at its own address | Team | | private, in your region | `services.dev deploy --region eu`, data kept there | Scale | ## Pick a branch A magic value makes a job take one branch with no person and no outside system: a party who never answers, a filing rejected once, a member whose coverage lapsed. Set it on the order's `metadata.sandbox`, as a party's email, or on a test clock for every job it holds. The [reference](https://services.dev/docs/reference/magic-values.md) lists all of them and the pages that show each one. ## Run a season before it starts apis.tax runs its whole spring before February. A test clock carries its own market, here 40 simulated preparers who ask more than reviews post at: ```bash npx services.dev test-clocks create 2027-01-15 --members 40 --market tight ``` ```txt title="magic values: market = tight, metadata.sandbox.outside = reject_once" ← tc_9Ts1 · test clock · frozen at 2027-01-15T14:00:00Z · market tight, 40 simulated members in preparers · test mode only ``` ```bash npx services.dev subscriptions seed tax-plan --count 120 --test-clock tc_9Ts1 ``` ```txt title="magic values: market = tight, metadata.sandbox.outside = reject_once" ← 120 Tax Plans on tc_9Ts1 · 120 simulated taxpayers · entities and states drawn from the seed 9Ts1 · simulated: true ``` Then three months, in one call. Every rung, mint, rejection, raise and extension fires in order, the same way it would on the brand's clock. The test clock's rules and the timers it fires are on [Timers and replay](https://services.dev/docs/service/timers.md#on-a-test-clock): ```bash npx services.dev tick 2027-04-16 --test-clock tc_9Ts1 ``` ```txt title="magic values: market = tight, metadata.sandbox.outside = reject_once" apis.tax · test mode · tc_9Ts1 · 2027-01-15 → 2027-04-16 · version 2027-01 · market tight minted 120 annual returns on 1 Feb, one for each Tax Plan filed 104 federal and 212 state returns · 9 rejected once, each repaired inside its window extended 16 returns, by each file clock's run tentative 3d rung · 0 dates missed fill 113 reviews · p90 3h40m to claim · raised 38 times · widened 4 · 0 unreached money recorded, never moved · 120 Tax Plan cycles, $288,000.00 · each return $0, inside its plan · signers' pay $9,420.00, preparers' $1,215.00 every act simulated: true · nothing reached the IRS, a state, Stripe or a member ``` The brand's own suite runs on the same clock, as `deploy` runs it: ```bash npx services.dev verify --test-clock tc_9Ts1 ``` ```txt title="magic values: market = tight, metadata.sandbox.outside = reject_once" apis.tax · 258 cases from 84 rows · test mode · 2027-01 on tc_9Ts1 258 passed · 0 failed · 72 live rows wait for deploy --live ``` The owner console shows test mode with the same screens, behind a test banner, so what you check in test is what you will read live. ## Controls | Call (CLI) | API | Event | On the console | Plan | |---|---|---|---|---| | `test-clocks create