GitHub sync

Noteser can sync your vault with a GitHub repo. One commit per sync, clean three-way merge, no plugins or extensions required — it talks to the GitHub Git Data API directly from the browser.

Connect a repo

  1. Click the GitHub ribbon icon or open Settings → GitHub sync.
  2. Click Connect to GitHub. The device-code modal opens — copy the code, click the GitHub link, paste, and authorise.
  3. Pick a repo from the list. The first push will commit every existing note.

Commit & sync

  • Open the Source Control sidebar tab (you can pin it).
  • Pending changes appear in the CHANGES tree.
  • Type a commit message (or leave blank to use the default Sync from Noteser ({{date}}) template).
  • Click Commit & Sync. Ctrl+Enter in the message box does the same thing.

The default commit message is configurable in Settings → GitHub sync → Default commit message. The {{date}} token substitutes to today's YYYY-MM-DD at commit time.

Conflicts

If you and another device both edited the same note since the last sync, the merge tab opens automatically. Each side is shown line-by-line; pick Mine / Theirs / Merge per chunk, then Apply.

If three or more conflicts open at once, the Merge batch view summarises them with bulk "Keep all mine" / "Take all theirs" buttons.

Vault encryption

Optional — encrypts note bodies before push. Enabled in Settings → GitHub sync → Vault encryption. Pick a 12+ character passphrase; it's never persisted. Every page refresh re-locks the vault; you'll be prompted on next sync.

There is no recovery if you forget the passphrase. Use a password manager.

Reset to remote

Settings → GitHub sync → Reset to remote discards local edits to pushed notes and pulls fresh from GitHub. Unpushed local notes are preserved by default.

GitHub sync — Noteser help