Safe changes

Use a dry run to preview one command without saving it. Use a draft to collect several edits before publication. The examples use example-project-id as a physical Firebase project ID.

Choose dry run or draft

Use --dry-run when you want to answer "what would this command do?" without persisting anything:

fbrcm update checkout_enabled \
  --project '=example-project-id' \
  --type boolean \
  --value true \
  --dry-run

The command prepares the candidate, validates it with Firebase, prints the diff, and suppresses publication and local writes.

Use --draft when you want to collect related edits:

fbrcm update checkout_enabled \
  --project '=example-project-id' \
  --type boolean \
  --value true \
  --draft

fbrcm update checkout_title \
  --project '=example-project-id' \
  --type string \
  --value 'Try the new checkout' \
  --draft

Once a target has a draft, immediate publication commands refuse to bypass it. Continue editing the draft or publish or discard it explicitly.

Review local intent

Compare the draft with the immutable base it started from:

fbrcm draft diff example-project-id --against base

This operation is local. It answers "what did I change?"

To preview what publication would do against the latest Firebase state:

fbrcm draft diff example-project-id --against current

This fetches the current template, performs the same three-way merge used by publication, and shows current → candidate. Add --cached only when you explicitly want to avoid the network and accept that the snapshot may be stale.

Add a change note

Firebase versions can carry a single-line change note:

fbrcm draft change-note example-project-id 'Enable checkout experiment'

You can also use --change-note on a mutation or override the stored note at publish time.

Publish

fbrcm draft publish example-project-id

For each draft, fbrcm:

1. fetches current Firebase state;
2. rebases local intent with a three-way merge;
3. stops if local and remote changes conflict;
4. shows the exact candidate diff;
5. validates the candidate with Firebase; and
6. publishes it with ETag protection.

Conflicts and failed validation preserve the draft. If Firebase already contains the intended result, fbrcm avoids creating a redundant version and cleans up the draft after a live publish.

Work across projects

Batch publication is intentionally non-atomic. fbrcm fetches, reviews, validates, and publishes each target independently:

fbrcm draft publish --all

A failure in one project does not hide the results for the others. Treat the final report as a set of per-target outcomes and retry only failed targets.

Discard a draft

Discarding removes local draft state and never contacts Firebase:

fbrcm draft discard example-project-id

Human mode shows the local base-to-draft diff before confirmation. Use fbrcm draft show example-project-id --raw first when you need to recover or archive a damaged draft envelope.

Which one to use

For one obvious edit, start with --dry-run, inspect the diff, then rerun the command normally. For multiple edits, use a draft from the start and publish it only after reviewing --against current.