For iOS iPadOS users (Working Copy)

For video learners, here is a great video made by David Allen. (This video might be out-dated, depends on your Working Copy's version.)

NOTE: If you are a student, you can sign up github student pack and apply for free Working Copy Pro.

1. Pay for the Pro version of the App Working Copy, it is cheap since you will never bother by iCloud crashing your Logseq anymore.
2. Open Working Copy > Settings(⚙️) > Hosting Providers > Click Test > Sign-in to your GitHub account.
3. Open Working Copy > click + > Clone repository > Choose your repo and hit Clone.
4. When download is done:
   • Tap on the repo, in my case: Logseq_deb

• In the repo, tap on Repository

• In the Repository, tap on down carrot

• In the down carrot menu, choose > Link Repository to, then choose Directory.

• Make sure your in My iPhone/iPad (I would suggest don't choose iCloud to avoid some syncing issue) > create a new sub-folder under the Logseq-icon one (I would suggest don't name the folder with the same name as your repo.) > click Done

5. Open Logseq and add new graph to that folder.

6. First create two standalone shortcuts. An automation can only run an existing shortcut, so these must already exist before you set up the automations in step 7. Open Shortcuts > the Shortcuts tab > tap the + in the upper-right:

   • Shortcut 1 — "pull logseq repo":

     • Search actions > Pull Repository - Repo: your Logseq repo
     • Name the shortcut pull logseq repo (or anything you'll recognize).

   • Shortcut 2 — "push logseq repo": create another shortcut and add these actions in order:

     • Stage for Commit - Path: *, Repo: your Logseq repo
     • If condition
       • Input: Select Magic Variable - choose Filenames below the Stage for Commit action
       • Condition: has any value
       • Put the next two actions (Commit Repository and Push Repository) inside this If condition, so a commit is only made when changes are detected — this avoids empty commits.
     • Commit Repository - Repo: your Logseq repo, Message: Auto-commit from iOS/iPadOS
       • NOTE: In Commit Repository, you can toggle off Fail when nothing to Commit if you find the failure notification annoying. I prefer to keep it on to prevent empty commit and empty push.
     • Push Repository - Repo: your Logseq repo
     • Name the shortcut push logseq repo. It should look like:

7. Now wire them into automations. Open Shortcuts > Automation > Create Personal Automation:

   • On App Open:
     • App > choose Logseq > click Next
     • Search actions > Run Shortcut > choose pull logseq repo
     • Turn off ask before running (or leave it on up to you)
   • On App Close:
     • App > choose Logseq > click Next
     • Search actions > Run Shortcut > choose push logseq repo
     • Turn off ask before running (or leave it on up to you)

8. Type something, exit Logseq, and wait few minutes to see if what you typed has also appear in GitHub.

9. If nothing goes wrong, you are a happy Logseq user!