sync

mprove sync allows you to sync uncommitted changes between local and server dev repositories while working with project files on your local machine.

mprove sync applies LOCAL repo state to server repo.

mprove sync --from-server applies SERVER repo state to local repo.

Mprove sync does not mix states. You chose what state to use by specifying or not specifying --from-server option.

For "sync" to work, the Local and Server dev repositories must be on the same branch and commit

Workflows

You can change your approach depending on the task.

Workflow "Commit on Local machine":

Make changes on Local machine
Apply local changes to server repo using mprove sync
Check and fix validation errors in web UI
Apply server repo changes to local repo using mprove sync --from-server
Commit changes on Local machine
Push changes from Local machine to Remote using git push
Revert Dev repo to last-commit and pull changes from Remote

Workflow "Commit on Dev (web UI)":

Make changes on Local machine
Apply local changes to server repo using mprove sync
Check and fix validation errors (web UI)
Commit changes on Dev (web UI)
Push changes from Dev to Remote (web UI)
Discard git changes on Local machine
Pull changes from the Remote to Local machine

Usage

➜  ~ mprove sync -h
Overwrite SERVER repo state using local repo state and vice versa, depending on the "--from-server" option

━━━ Usage ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

$ mprove sync

━━━ Options ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  --project-id #0       Project Id
  --env #0              (default "prod") Environment
  --local-path #0       (optional, if not specified then the current working directory is used) Absolute path of local git repository
  --from-server         (default false) if set, then server uncommitted changes overwrite local uncommitted changes
  --get-repo            (default false), show repo in output
  --get-repo-nodes      (default false), show repo nodes in output
  --get-errors          (default false), show validation errors in output
  --json                (default false)
  --debug               (default false) add debug to output
  --env-file-path #0    (optional) Path to ".env" file

━━━ Examples ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Apply LOCAL uncommitted repo state to the server repo
  $ mprove sync

Apply SERVER uncommitted repo state to the local repo
  $ mprove sync --from-server

Example Output

➜  ~ mprove sync

message:                Sync completed
appliedChangesOnLocal: 
  (empty array)
appliedChangesOnServer: 
  - (modified) README.md
validationErrorsTotal:  0
url:                    http://localhost:3000/org/AWNCAHWLFQTQJYCH3ZSE/project/DXYE72ODCP5LWPWH2EXQ/repo/T2SQOCM8KK2QMRYYH75N/branch/main/env/prod/builder