What's changing: Before deploy, deploy sync-config, deploy service-config, stop, destroy, and compact do anything, the CLI now prints the resolved target instance name and IDs; status shows the target first too, with the API URL for self-hosted instances. deploy and deploy service-config also warn when the local service.yaml name differs from the instance name, since deploying renames the instance. All deploy commands gain a new --dry-run flag that prints the target, runs validations, shows a diff of the sync config and the changed service config sections, and stops without deploying.
High priority — existing docs are now inaccurate or incomplete
None identified.
For reviewer consideration — worth documenting
- New
--dry-run flag on powersync deploy, powersync deploy sync-config, and powersync deploy service-config. The CLI page's Common Commands table lists these three deploy commands with no mention of a dry-run option, and the "Deploying From CI" section describes running powersync deploy directly with no preview step.
- Pre-action target instance confirmation (name and IDs) now shown before
deploy, stop, destroy, and compact, and before status output. No page currently mentions this confirmation step; the Common Commands table and the destroy/stop/compact rows are the closest existing coverage.
Source PR: powersync-ja/powersync-cli#64 — open, labeled "Product Visibility"
Filed automatically by Claude Code (claude-sonnet-5). A human must verify the scope, prepare the docs PR, and publish it only once this update has been released.
What's changing: Before
deploy,deploy sync-config,deploy service-config,stop,destroy, andcompactdo anything, the CLI now prints the resolved target instance name and IDs;statusshows the target first too, with the API URL for self-hosted instances.deployanddeploy service-configalso warn when the localservice.yamlnamediffers from the instance name, since deploying renames the instance. All deploy commands gain a new--dry-runflag that prints the target, runs validations, shows a diff of the sync config and the changed service config sections, and stops without deploying.High priority — existing docs are now inaccurate or incomplete
None identified.
For reviewer consideration — worth documenting
--dry-runflag onpowersync deploy,powersync deploy sync-config, andpowersync deploy service-config. The CLI page's Common Commands table lists these three deploy commands with no mention of a dry-run option, and the "Deploying From CI" section describes runningpowersync deploydirectly with no preview step.deploy,stop,destroy, andcompact, and beforestatusoutput. No page currently mentions this confirmation step; the Common Commands table and thedestroy/stop/compactrows are the closest existing coverage.Source PR: powersync-ja/powersync-cli#64 — open, labeled "Product Visibility"
Filed automatically by Claude Code (
claude-sonnet-5). A human must verify the scope, prepare the docs PR, and publish it only once this update has been released.