Skip to main content
Development tokens are temporary tokens that let your app connect to PowerSync before you integrate an auth provider. Each token signs in as the user ID you choose, so you can also use one to check what a specific user syncs.

Generating a Development Token

  1. In the PowerSync Dashboard, select your project and instance
  2. Go to the Client Auth view
  3. Check the Development tokens setting and save your changes
  4. Click the Connect button in the top bar
  5. Enter a user ID:
    • If your data isn’t filtered by user (same data syncs to all users), you can use any value (e.g., test-user).
  • If your data is filtered by , use a user ID that matches a user in your database. PowerSync uses this (e.g. auth.user_id() in Sync Streams) to determine what to sync.
  1. Click Generate Token and copy the token
Development tokens expire after 12 hours.

Usage

Using with Your Application

While you build your app, use a development token to connect it to PowerSync. Update the fetchCredentials() function in your backend connector to return the generated token.

Using with Sync Test

If you’re on PowerSync Cloud, use Sync Test in the PowerSync Dashboard to check what a specific user syncs. Sync Test generates a development token for the user ID you enter and connects a client in your browser with it. You do not need to copy the token.

Using with the Sync Diagnostics Client

If you self-host, use the Sync Diagnostics Client to check what a specific user syncs. See Test What a User Syncs for the steps.

Using with test-client

The test-client syncs without storing data in a client-side SQLite database. You can use it for load testing, for example to simulate many clients syncing at the same time. See the README for how to pass the development token to its commands.