Reckoneer / Stage 8
Stage 8BuildOperator

Live

The live stage is the terminal state of a Reckoneer run. It is reached after the operator has reviewed the preview URL and is satisfied with the result.

Clicking Publish sends a single Admin API call: set this theme's role to 'main'. Shopify immediately swaps the published theme — the new theme takes over the storefront atomically. The previous theme is automatically demoted to 'unpublished' and remains in the store's theme library as a fallback.

The run advances to Live state. The LivePanel shows: the store URL, the published theme link in Shopify Admin, and the preview URL (still valid as a reference). An Update / Re-deploy option re-opens the BuildThemePanel for future changes — making updates idempotent (the same theme ID is reused, not a new one created).

If the published result has problems, the previous theme can be manually re-published in Shopify Admin in seconds — no code changes required.

Terms
Atomic swap

An operation that switches from one state to another instantaneously with no intermediate state visible. When Reckoneer publishes the theme, Shopify switches from the old theme to the new one in a single operation — customers never see a half-built state.

AnalogyA stage set change in complete darkness. The lights go out, the crew swaps the entire set in seconds, the lights come back on — the audience sees the new scene with no glimpse of the transition.
OriginAtomic: from Greek 'atomos' (indivisible). In computing: an operation that either completes fully or does not happen at all — it cannot be partially done.
Idempotent re-deploy

Re-running the build and push process for a run produces the same result as running it the first time — using the same theme ID in the store rather than creating a new one. No orphaned themes, no duplicated entries.

AnalogyRepainting a room you already painted. You do not build a new room — you apply new paint to the existing room. The room ID stays the same; the content is updated in place.
OriginIdempotent: from Latin 'idem' (the same) + 'potens' (powerful). An operation that has the same effect whether applied once or many times.
Fallback theme

The previous live theme, automatically demoted to unpublished when a new theme is published. Remains in the Shopify theme library and can be re-published instantly if the new theme has problems.

AnalogyA spare tyre in the boot. You never want to use it, but if the new tyre fails (new theme has problems), you can swap back immediately without being stranded.
OriginFallback: 'fall' from Old English 'feallan' (to drop) + 'back' (returning to a prior position). A contingency that restores a prior working state.