☁️ Cloud saves

Cloud saves guide for Idle Pockets. How progress syncs between devices and accounts.

Guest vs account

Guests save only in local browser storage. Signing in stores a JSON save per account in Supabase.

On load, the newer matching character wins — unless a moderator bump (mod epoch) forces the cloud row.

Moderator edits

Staff can edit `game_saves.state` in Supabase. Table Editor / SQL edits auto-bump mod_epoch so the client cannot overwrite them.

After an edit, ask the player to switch tabs back to the game (or reload) — signed-in clients pull cloud updates when the tab becomes visible again.

When cloud uploads

Progress always saves locally every few seconds. Cloud upload runs when you hide or close the tab, on sign-in, and about every 5 minutes as a backup.