Git integration

TreeWrite can commit and push your document to a Git repository, to back it up or to sync it across computers. It uses the Git installed on your computer, with your SSH keys and credentials.

Setup

1. Open Settings › Git.
2. If the file is not in a repository, click Initialize repository here.
3. If the repository has no remote, type its URL and click Add remote and push.
4. Turn on Sync this file, and pick a mode:
   • Sync pulls the changes of other computers, then pushes yours.
   • Backup only pushes, for a document only one computer edits. If the remote has changes this computer does not have, the sync pauses.

When it syncs

After a pause in your work, every few minutes, when the file is opened, when you switch to another document or close TreeWrite, and when you click the sync status, then Sync now. In Backup mode, the timer and the opening push instead of pull. The minutes are in Settings › Git.

Each commit has only the document, its assets and its review log.

Merge conflicts

TreeWrite merges your document bullet by bullet. A bullet changed on both computers keeps the version of this one, and you are told. An edit wins over a removal. A conflict in another file of the repository pauses the sync.

Sync status

The sync status in the header says whether your changes were pushed. Sync paused means something needs you, as a refused credential: fix it and click Retry.