# Persistly Public Website

Canonical site: https://persistly.app/
Documentation: https://docs.persistly.app/
Dashboard sign-up: https://dashboard.persistly.app/
Dashboard sign-in: https://dashboard.persistly.app/sign-in

Persistly is cloud save infrastructure for games. It helps developers add local-first saves, named save slots, account data, stage and production runtime keys, restore history, and conflict-safe sync without building a custom save backend.

## Best Fit

- Single-player, idle, incremental, casual, premium, and async games.
- Games that need durable progress, cross-device resume, explicit conflicts, and restore history.
- Developers who want SDK-first integration for JavaScript, Unity, or Godot.

## Not A Fit

- Real-time multiplayer state, matchmaking, server-authoritative combat, broad analytics ingestion, file hosting, or general backend replacement.
- Persistly should not be used to sync every frame or store arbitrary large binary blobs.

## Main Public Pages

- Home: https://persistly.app/
- Features: https://persistly.app/features
- Use cases: https://persistly.app/use-cases
- Pricing: https://persistly.app/pricing
- Resources: https://persistly.app/resources
- About: https://persistly.app/about

## Developer Resources

- Add cloud saves to an idle game: https://persistly.app/resources/how-to-add-cloud-saves-to-an-idle-game
- One save vs multiple save slots: https://persistly.app/resources/one-save-vs-multiple-save-slots
- Save data vs slotInfo: https://persistly.app/resources/save-data-vs-slot-info
- Cloud saves without sign-in: https://persistly.app/resources/cloud-saves-without-sign-in
- Firebase, Supabase, or Auth0 sign-in with cloud saves: https://persistly.app/resources/firebase-auth-cloud-saves-browser-unity-godot
- Stage vs production runtime keys: https://persistly.app/resources/stage-vs-production-runtime-keys
- JavaScript SDK article: https://persistly.app/resources/javascript-sdk-install-save-load
- JavaScript SDK jsDelivr HTML demo: https://persistly.app/resources/javascript-sdk-jsdelivr-html-demo
- Basic JavaScript save sync: https://persistly.app/resources/js-sdk-basic-save-sync
- Unity SDK article: https://persistly.app/resources/unity-sdk-install-save-load
- Save player progress in Unity: https://persistly.app/resources/unity-save-player-progress
- Godot SDK article: https://persistly.app/resources/godot-sdk-install-save-load
- Building a Godot cloud save system: https://persistly.app/resources/godot-cloud-save-system
- Transfer saves between browser and Godot: https://persistly.app/resources/transfer-saves-between-browser-and-godot
- Offline-first save systems: https://persistly.app/resources/offline-first-save-systems
- Handling save conflicts: https://persistly.app/resources/handling-save-conflicts

## SDKs

- JavaScript docs: https://docs.persistly.app/sdk/javascript
- Unity docs: https://docs.persistly.app/sdk/unity
- Godot docs: https://docs.persistly.app/sdk/godot
- Template center: https://docs.persistly.app/templates
- Firebase Auth Bridge: https://docs.persistly.app/auth/firebase
- Supabase Auth Bridge: https://docs.persistly.app/auth/supabase
- Auth0 Auth Bridge: https://docs.persistly.app/auth/auth0
- Anonymous transfer codes: https://docs.persistly.app/account-transfer-codes

## Integration Guidance

Use the game-friendly SDK facade, `PersistlyGameSaves`, first:

- Idle and incremental games should load local progress before starting the loop, save locally on meaningful progress changes, and sync at safe moments such as upgrades, milestones, tab hide, reconnect, or menu/checkpoint events.
- One-save games use `saveData` / `loadData` style methods where available.
- Multi-slot games use `saveSlot`, `loadSlot`, and `listSlots()` with stable developer slot ids.
- Treat `slotInfo` as preview/selection data and `data` as full playable save state. The facade hides internal save ids and raw save-storage routes.
- Use accountData helpers such as `saveAccountData`, `patchAccountData`, and local account-data inspection for shared account-wide data.
- Advanced integrations can use account/session/slot runtime APIs when the game owns identity or recovery flows.
- Auth Bridge lets games exchange a Firebase ID token, Supabase access token, or Auth0 token for a Persistly account session, then keep using normal save/load/sync helpers.
- Auth Bridge has two account modes: `authRequired` for sign-in before cloud sync, and `anonymousFirst` for save-now connect-later flows. Provider tokens come from the Firebase, Supabase, or Auth0 SDKs and belong only on Auth Bridge sign-in/connect calls.
- For anonymous-first connect-later, use the provider-specific connect helper after the player signs in. If Persistly returns `account_auth_conflict`, keep local progress intact and show recovery UI instead of clearing local state or switching accounts automatically.
- Free workspaces can test Auth Bridge with Stage runtime keys. Production Auth Bridge requires a paid workspace plan and returns `403 auth_bridge_requires_paid_plan` for Free workspaces.
- No-login games can use short-lived transfer codes to move an existing anonymous save from one device to another while the original device still has the account session. Transfer codes are not persistent passwords, usernames, email login, `playerRef` lookup, or `externalAccountRef` lookup.

Persistly runtime keys are public client runtime keys for game clients. They should still be treated as project credentials, kept out of logs and support screenshots, and rotated from the dashboard if exposed.

## Legal Pages

- Terms: https://persistly.app/terms
- Privacy: https://persistly.app/privacy
- Billing Policy: https://persistly.app/billing-policy
- Cookie Policy: https://persistly.app/cookie-policy
- Data Processing Addendum: https://persistly.app/dpa
- SDK Terms: https://persistly.app/sdk-terms
- Subprocessors: https://persistly.app/subprocessors

## Discovery Files

- Sitemap: https://persistly.app/sitemap.xml
- Robots: https://persistly.app/robots.txt
- LLM summary: https://persistly.app/llms.txt
- Full LLM summary: https://persistly.app/llms-full.txt
- Security contact: https://persistly.app/.well-known/security.txt

## Common Redirects For AI And Search Discovery

- https://persistly.app/signup, https://persistly.app/sign-up, https://persistly.app/register, https://persistly.app/refister, https://persistly.app/join, https://persistly.app/create-account, https://persistly.app/start-free, https://persistly.app/try, and https://persistly.app/trial redirect to https://dashboard.persistly.app/sign-up
- https://persistly.app/signin, https://persistly.app/sign-in, https://persistly.app/login, and https://persistly.app/log-in redirect to https://dashboard.persistly.app/sign-in
- https://persistly.app/dashboard, https://persistly.app/app, and https://persistly.app/console redirect to https://dashboard.persistly.app/
- https://persistly.app/docs and https://persistly.app/documentation redirect to https://docs.persistly.app/
- https://persistly.app/get-started, https://persistly.app/getting-started, https://persistly.app/start, https://persistly.app/quickstart, and https://persistly.app/guide redirect to https://docs.persistly.app/quickstart
- https://persistly.app/guides redirects to https://docs.persistly.app/
- https://persistly.app/sdk and https://persistly.app/sdks redirect to https://docs.persistly.app/sdk
- https://persistly.app/sdk/javascript redirects to https://docs.persistly.app/sdk/javascript
- https://persistly.app/javascript, https://persistly.app/js, https://persistly.app/sdk/js, and https://persistly.app/sdks/js redirect to https://docs.persistly.app/sdk/javascript
- https://persistly.app/unity redirects to https://docs.persistly.app/sdk/unity
- https://persistly.app/godot redirects to https://docs.persistly.app/sdk/godot
- https://persistly.app/templates redirects to https://docs.persistly.app/templates
- https://persistly.app/api, https://persistly.app/reference, https://persistly.app/api-docs, https://persistly.app/api-reference, and https://persistly.app/reference/api redirect to https://docs.persistly.app/runtime-api
- https://persistly.app/openapi and https://persistly.app/swagger redirect to https://docs.persistly.app/openapi-and-contract
- https://persistly.app/openapi.json redirects to https://docs.persistly.app/openapi.json
- https://persistly.app/openapi.yaml redirects to https://docs.persistly.app/openapi.yaml
- https://persistly.app/help and https://persistly.app/support redirect to https://docs.persistly.app/
- https://persistly.app/contact redirects to https://persistly.app/about