DSPACE

democratized.space
Profile avatar

Cloud Sync

      Docs
      Cloud Sync

      Cloud Sync

      Cloud Sync stores sanitized backups in a private GitHub gist so you can recover across browsers or devices.

      What Cloud Sync handles

      • Game-state backups
      • Custom content backups (Custom quests, items, and processes)
      • Upload/download operations tied to your configured gist

      Setup

      1. Create a GitHub personal access token with gist scope.
      2. Create or choose a private gist.
      3. Open /cloudsync (or Settings cloud-sync controls).
      4. Save token and Gist ID.
      5. Run an upload, then verify a download from another profile/device.

      Credentials and storage

      • Token and gist ID are stored locally in IndexedDB.
      • Credentials stay on your device except for authenticated requests to GitHub APIs.
      • In Settings, use Clear / Log out actions to remove them from the device.

      Operational guidance

      • Keep manual exports from /gamesaves and /contentbackup as a fallback.
      • Rotate tokens if a device is lost or shared.
      • Use separate tokens for Cloud Sync and contribution actions if you want tighter least-privilege.

      Troubleshooting

      • 401/403: token scope invalid or token revoked.
      • 404 gist: incorrect gist ID or missing access rights.
      • Sync appears stale: verify current profile writes before uploading and reload after download.