PlayDrop

Reference documentation

Playdrop Troubleshooting

Troubleshooting prompts and workflows for PlayDrop creators.

Updated April 6, 2026

Playdrop Troubleshooting

Start with the docs tree

bash example

playdrop documentation browse

Then open the most relevant entry:

bash example

playdrop documentation read cli
playdrop documentation read runtime
playdrop documentation read publishing

Common problems

Login or account confusion

bash example

playdrop auth whoami
playdrop auth login

If the wrong environment is active, log in again with the correct one.

Local preview says it cannot reach the dev server

  • Start the app with playdrop project dev <name>
  • Make sure the app build succeeds
  • Re-run playdrop project capture <name> and inspect the logs and screenshot

Documentation command fails

  • Check that your environment has a CDN base configured
  • Retry:

bash example

playdrop documentation browse
playdrop documentation read runtime

TypeScript project is inventing SDK APIs

  • Install the public SDK types tarball or use a downloaded sample that already vendors it
  • Run typecheck before publish
  • Read:
    • runtime
    • examples

Remix source does not install cleanly

  • Re-run npm install
  • Check the downloaded project for vendor/playdrop-sdk-types.tgz
  • If it is a public sample, read examples

Listing media looks weak

Read:

  • publishing

Still stuck

Capture proof and inspect it:

bash example

playdrop project capture <target> --timeout 20 --screenshot tmp/capture.png

If you think the CLI or SDK is wrong or missing something, submit feedback:

bash example

playdrop feedback send --title "Problem summary" --comment "What you tried and what failed"