Troubleshooting

Build cannot resolve Android package

• Verify that GithubUser and GithubToken are defined in local.properties for GitHub Packages access.
• Verify the GitHub Packages repository is declared in Gradle repositories.

Workout launch fails due to authentication

• Verify JWT is generated server-side and not expired.
• Verify the JWT follows the contract documented in Server-side Request Authentication.
• Verify public/private key pair configuration is aligned between your backend and WorkoutKit.
• Verify sub is present when the GraphQL operation requires authenticated end-user context.

Workout controller/fragment does not start

• Verify GraphQL session payload is complete and matches expected workout type.
• Verify the required WorkoutKitToken was returned by the session request and passed to the controller/fragment constructor.
• Verify the session payload was fetched close enough to launch time that the returned WorkoutKitToken is still valid.

Apollo schema generation issues in sample apps

• Recheck endpoint/auth values in local configuration files.
• Use CLI fallback commands when IDE plugin integration fails.