Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

GitHub

Sync your journal to a GitHub repository.

Setup

  1. Create a private repository on github.com.
  2. In Surebeans: Sync → Add Remote → GitHub.
  3. Enter the repository URL.
  4. Authenticate with one of the methods below.

GitHub remote setup

Option A: Personal Access Token

  1. Generate a Personal Access Token with repo scope.
  2. Paste the token into the Token field.

Option B: OAuth

  1. Toggle Use OAuth in the sync setup.
  2. Click Sign in. Your browser opens for GitHub authorization.
  3. Approve the request and return to Surebeans.

A default GitHub client ID is built in, so no additional configuration is needed.

Configuration

FieldRequiredNotes
Repository URLYeshttps://github.com/you/my-budget
TokenPAT onlyghp_xxxxxxxxxxxx
Use OAuthOAuth onlyToggle on, then click Sign in

Platform support

PlatformSupported
DesktopYes
BrowserYes

In the browser, by default Surebeans routes web requests to GitHub through a proxy at cors.surebeans.net. This is necessary since GitHub’s CORS settings do not allow requests to github.com from surebeans.net. Per our privacy policy, we do not store or track any data.

Tips

  • Use a private repo to keep financial data confidential.
  • The token is stored locally and never sent anywhere except GitHub.