| name | start-devtools |
| description | Start Adapty Devtools app for SDK testing. Use when need to run, launch, or test the devtools example app on iOS or Android simulator/emulator. |
| argument-hint | [ios|android] |
| disable-model-invocation | true |
| allowed-tools | Bash, Read, AskUserQuestion |
Start Devtools
Build and run the Adapty Devtools app on a simulator/emulator.
Platform
Platform argument: $ARGUMENTS (defaults to ios if empty)
Steps
All commands run from repository root.
1. Check environment
Verify required tools are installed:
node --version && yarn --version && xcodebuild -version 2>/dev/null | head -1 && java -version 2>&1 | head -1
Requirements: Node.js 22+, Xcode 26+, JDK 21 (for Android).
If something is missing, inform user and stop.
2. Check credentials
cat examples/adapty-devtools/.adapty-credentials.json 2>/dev/null || echo "NO_CREDENTIALS"
If credentials don't exist or are incomplete, use AskUserQuestion to collect:
- Adapty API token (from Adapty dashboard)
- iOS bundle identifier (must match App Store Connect)
- Android application ID (must match Google Play Console)
- Placement ID (paywall placement from Adapty)
- Onboarding placement ID (optional)
3. Setup credentials (if needed)
Install dependencies first, then run credentials script:
yarn install
cd examples/adapty-devtools && yarn install --ignore-scripts
cd examples/adapty-devtools && node ../../scripts/credentials.mjs \
--token=YOUR_TOKEN \
--ios-bundle=YOUR_BUNDLE \
--android-id=YOUR_APP_ID \
--placement-id=YOUR_PLACEMENT \
--onboarding-placement-id=YOUR_ONBOARDING_PLACEMENT
4. Build and run
From repository root:
./scripts/start-devtools.sh $ARGUMENTS
CLI Parameters for credentials.mjs
Non-interactive mode (all required):
--token=<adapty-api-token>--ios-bundle=<com.example.app>--android-id=<com.example.app>--placement-id=<placement-id>--onboarding-placement-id=<placement-id> (optional)--skip-onboarding (skip onboarding placement)--force-bundle (force update native projects even if unchanged)
