Before you continue
Before submitting a bug report, please review our troubleshooting documentation at https://developer.amazon.com/docs/kepler-tv/troubleshoot-overview.html.
If you still want to file a bug report, please make sure to fill in all the details below and provide the necessary information.
NOTE: PLEASE ONLY REPORT A SINGLE BUG USING THIS TEMPLATE.
If you’re experiencing multiple issues, please file a separate report for each.
Bug Description
1. Summary
Provide a brief description of the bug in the SDK and its impact on app functionality.
App Name:
App Link on Amazon Appstore (found through Developer Console → Actions column in App List → View on Amazon.com):
Bug Severity
Select one that applies
- X Impacts operation of app
- X Blocks current development
- Improvement suggestion
- Issue with documentation (If selected, please share the doc link and describe the issue)
- Other
2. Steps to Reproduce
- kepler device install-app --device “Simulator” --directory “/Users/sofia.lozada/Documents/client-apps-kepler” --buildType “Debug” --packagePath “/Users/sofia.lozada/Documents/client-apps-kepler/build/private/kepler/com.univision.prendetv/0.1/vega/aarch64/Debug/com.univision.prendetv_aarch64.vpkg”
3. Observed Behavior
Explain what actually happened, noting any discrepancies or malfunctions.
<!-- Answer here -->
4. Expected Behavior
Describe what you expected the SDK to do under normal operation.
2025-10-04 22:46:21.147 [warning] Failed
2025-10-04 22:46:21.147 [warning] ERR: Error: Command failed: vda -s emulator-5554 shell 'vpm install /tmp/com.univision.prendetv_aarch64.vpkg'
2025-10-04 22:46:21.170 [warning] Kepler operation FAILED due to an irrecoverable error: Failed
Additional logs can be found at /Users/sofia.lozada/.kepler/logs
2025-10-04 22:48:27.277 [info] kepler device install-app --device "Simulator" --directory "/Users/sofia.lozada/Documents/client-apps-kepler" --buildType "Debug" --packagePath "/Users/sofia.lozada/Documents/client-apps-kepler/build/private/kepler/com.univision.prendetv/0.1/vega/aarch64/Debug/com.univision.prendetv_aarch64.vpkg"
2025-10-04 22:48:29.143 [warning] Failed
2025-10-04 22:48:29.143 [warning] ERR: Error: Command failed: vda -s emulator-5554 shell 'vpm install /tmp/com.univision.prendetv_aarch64.vpkg'
2025-10-04 22:48:29.164 [warning] Kepler operation FAILED due to an irrecoverable error: Failed
Additional logs can be found at /Users/sofia.lozada/.kepler/logs
2025-10-04 23:25:08.054 [info] kepler device install-app --device "Simulator" --directory "/Users/sofia.lozada/Documents/client-apps-kepler" --buildType "Debug" --packagePath "/Users/sofia.lozada/Documents/client-apps-kepler/build/private/kepler/com.univision.prendetv/0.1/vega/aarch64/Debug/com.univision.prendetv_aarch64.vpkg"
4.a Possible Root Cause & Temporary Workaround
Fill out anything you have tried. If you don’t know, N/A is acceptable
N/A
5. Logs or crash report
(Please make sure to provide relevant logs as attachment)
For crash issues, please refer this guide for faster troubleshooting: https://developer.amazon.com/docs/kepler-tv/detect-crash.html.
-
For issues with Kepler Studio Extension, please share log files from below folders:
~/.vscode/extensions/amazon.kepler-extension-<version>/ExtensionLogs ~/.vscode/extensions/amazon.kepler-ui-extension-<version>/ExtensionLogs
E:
2025-10-04 23:21:19 info [DeviceManagerHandler]: runCommandsInternal: emulator-5554, pm has-feature com.fireos.sdk.kepler
2025-10-04 23:21:20 info [DeviceManagerHandler]: /var/folders/xj/cy6bdktn2q3dcrfml053_0r00000gp/T/.kdm_oNmJU9/.kdm_isFOSPlusDeviceType
2025-10-04 23:21:20 info [DeviceManagerHandler]: code: 127, output: 0, error: 51
2025-10-04 23:21:20 debug [DeviceManagerHandler]: Found Simulator device: emulator-5554
2025-10-04 23:21:20 debug [DeviceManagerHandler]: Found Vvrp device: emulator-5554
2025-10-04 23:21:20 info [DeviceManagerHandler]: runCommandsInternal: emulator-5554, vpm list apps isVegaDeviceType
2025-10-04 23:21:20 info [DeviceManagerHandler]: runCommandsInternal: emulator-5554, vdcm get com.amazon.devconf/system/device-info/device-type-id,uname -m,vdcm get com.amazon.devconf/system/device-info/profile,uname -n,vsm developer-mode,vdcm get com.amazon.devconf/system/device-info/product-name,vdcm get com.amazon.devconf/system/device-info/build-desc getDeviceIdTypeInfo
2025-10-04 23:21:20 debug [DeviceManagerHandler]: Found Simulator device: emulator-5554
2025-10-04 23:21:20 info [DeviceManagerHandler]: runCommandsInternal: emulator-5554, uname -m isConnected
2025-10-04 23:21:20 debug [DeviceManagerHandler]: Enable port forwarding command generation successful
2025-10-04 23:21:21 debug [EnvUtils]: Environment variable KEPLER_SDK_PATH: found
2025-10-04 23:21:21 debug [OperationalMetricClient]: creating new telemetry client with componentName=keplercli keplerCliVersion=0.200.0 sdkPath=/Users/sofia.lozada/kepler/sdk/0.200.0
2025-10-04 23:21:21 info [Timing]: device-StartPortForwardingHandler.handle completed successfully in 1.2 s
2025-10-04 23:21:21 info [EnvUtils]: getting absolute path for /Users/sofia.lozada/kepler/sdk/0.20.3719 (from env variable KEPLER_SDK_PATH)
2025-10-04 23:21:21 info [EnvUtils]: Base path for installation: /Users/sofia.lozada/kepler
Installation path: /Users/sofia.lozada/kepler/sdk/0.200.0
2025-10-04 23:21:21 debug [OperationalMetricClient]: emitting metric with payload: {“operationName”:“device”,“subOperationName”:“StartPortForwardingHandler.handle”,“metricType”:“Count”,“metricValue”:1}
2025-10-04 23:21:21 debug [OperationalMetricClient]: emitting metric with payload: {“basePayload”:{“metricType”:“Latency”,“operationName”:“device”,“metricValue”:1.195140708,“subOperationName”:“StartPortForwardingHandler.handle”},“isOperational”:true,“isBehavioral”:true}
2025-10-04 23:21:21 debug [OperationalMetricClient]: Telemetry service already running with PID: 27482
2025-10-04 23:21:21 debug [OperationalMetricClient]: Data successfully appended to file
2025-10-04 23:21:21 debug [OperationalMetricClient]: Telemetry service already running with PID: 27482
2025-10-04 23:21:21 debug [OperationalMetricClient]: Data successfully appended to file
2025-10-04 23:21:22 debug [DeviceManagerHandler]: Created KeplerDeviceManager
2025-10-04 23:21:22 info [DeviceManagerHandler]: VDA check returned: 0
O: Vega Device Adapter version 2.1.0
Server Version 41
Platform Version 34.0.4
6. Environment
Please fill out the fields related to your bug below:
-
SDK Version: Output of
kepler --version0.20.3719 -
App State:
[Foreground/Background] -
OS Information
Please ssh into the device viakepler exec vda shelland copy the output fromcat /etc/os-releaseinto the answer section below. Note, if you don’t have a simulator running or device attachedkepler exec vda shellwill respond withvda: no devices/emulators found<!-- Answer here if applicable -->
7. Example Code Snippet / Screenshots / Screengrabs
Include any relevant code or component setup in React Native that can help reproduce the bug.
import { ExampleComponent } from 'custom-sdk';
<ExampleComponent config={{ key: 'value' }} />
Playback Issues
If this is a playback issue, please provide your content URL, any pre-conditions (like geo-location), and let us know if it’s x86 or arm7.
<!-- Describe your playback issue if applicable -->
Please share the following details in addition:_
- Player SDK:
[Bitmovin, Shaka, ...] - Player SDK Version:
[e.g. 1.23]- Audio Codecs:
[AAC, ...] - Video Codecs:
[h.264, mp4] - Manifest Types:
[m3u8, dash, etc ..]
- Audio Codecs:
Q: If applicable, please provide your media/content url
If this is created dynamically, tokenized, etc please provide a way for us to access it
[N/A or Content / Media Url for testing]
Q: Are there any special headers required to reproduce the issue you are facing?
[N/A or Insert Headers]
Additionally please provide the following if possible
Provide Screenshots / Screengrabs / Logs. Please include as much information as you can that will help debug.
<!-- Answer here if applicable -->
Additional Context
Any Additional Context you would like to provide?
Add any other relevant information, such as recent updates to the SDK, dependencies, or device OS that may affect the bug.
Fast refresh is also not working, NO connection to metro.
{
"name": "com.univision.prendetv",
"version": "0.0.0",
"files": [
"dist"
],
"scripts": {
"clean": "rm -rf bundle node_modules kepler-build assets dist",
"build": "npm-run-all compile lint:fix test",
"compile": "tsc -p tsconfig.json",
"test:snapshot": "jest --colors --updateSnapshot",
"start": "npm run create-translations && npm run start:dev",
"start:prod": "npm run create-translations && NODE_ENV=prod node node_modules/react-native/local-cli/cli.js start",
"start:stg": "npm run create-translations && NODE_ENV=stg node node_modules/react-native/local-cli/cli.js start",
"start:qa": "npm run create-translations && NODE_ENV=qa node node_modules/react-native/local-cli/cli.js start",
"start:dev": "npm run create-translations && NODE_ENV=dev node node_modules/react-native/local-cli/cli.js start",
"test": "jest --colors --coverage",
"test:clearCache": "jest --clearCache",
"lint": "eslint src --ext .ts,.tsx",
"start:simulator": "kepler device simulator start",
"bundle-kepler:debug": "react-native bundle --platform kepler --entry-file index.js --bundle-output build/lib/rn-bundles/Debug/index.bundle --assets-dest build/lib/rn-bundles/Debug/ --sourcemap-output build/lib/rn-bundles/Debug/index.bundle.map",
"create-component": "plop component",
"prepare": "husky",
"create-translations": "i18next-resources-for-ts interface -i src/translations/ -o src/types/resources.d.ts",
"postinstall": "patch-package",
"app:launch": "kepler device launch-app",
"app:build": "run-s build:release && npm run app:install && npm run app:launch -- -b Release",
"create-bundle-dirs:debug": "mkdir -p build/lib/rn-bundles/Debug/",
"hermes-kepler:debug": "react-native hermes-kepler --bundle-path build/lib/rn-bundles/Debug/index.bundle --out build/lib/rn-bundles/Debug/index.hermes.bundle",
"build:js:debug": "npm run create-translations && run-s create-bundle-dirs:debug bundle-kepler:debug hermes-kepler:debug",
"create-bundle-dirs:release": "mkdir -p build/lib/rn-bundles/Release/ && mkdirp build/private/debugging/Release/",
"bundle-kepler:release": "react-native bundle --platform kepler --entry-file index.js --dev false --bundle-output build/lib/rn-bundles/Release/index.bundle --assets-dest build/lib/rn-bundles/Release/ --sourcemap-output build/private/debugging/Release/index.bundle.map",
"hermes-kepler:release": "react-native hermes-kepler --bundle-path build/lib/rn-bundles/Release/index.bundle --out build/lib/rn-bundles/Release/index.hermes.bundle",
"build:js:release": "run-s create-bundle-dirs:release bundle-kepler:release hermes-kepler:release",
"build:native:debug": "kepler build -b Debug",
"build:debug": "npm run create-translations && react-native build-kepler --build-type Debug --build-number 182",
"build:native:release": "kepler build -b Release",
"build:release": "npm run create-translations && react-native build-kepler --build-type Release --build-number 182",
"build:app": "npm run create-translations && npm-run-all build:debug build:release",
"build:native": "kepler build -b Debug -b Release",
"build:module": "run-s build build:native",
"prepack": "run-s build:module"
},
"overrides": {
"react-native-gesture-handler": "$react-native-gesture-handler",
"@react-native-async-storage/async-storage": "npm:@amzn/react-native-async-storage__async-storage@~2.0.0"
},
"lint-staged": {
"*.{js,jsx,ts,tsx}": "eslint --fix"
},
"dependencies": {
"@akta-tech/lura-player-react-native": "https://w3.mp.lura.live/lura-player/react-native/4.3.1/@akta-tech/lura-player-react-native.tgz",
"@akta-tech/lura-player-react-native-conviva-plugin": "https://w3.mp.lura.live/lura-player/react-native/4.3.1/@akta-tech/lura-player-react-native-conviva-plugin.tgz",
"@akta-tech/lura-player-react-native-ui": "https://w3.mp.lura.live/lura-player/react-native/4.3.1/@akta-tech/lura-player-react-native-ui.tgz",
"@amzn/expo-asset": "~2.0.0",
"@amzn/expo-constants": "~2.0.0",
"@amzn/expo-font": "~2.0.0",
"@amzn/headless-task-manager": "^1.0.0",
"@amzn/kepler-media-account-login": "^1.1.0",
"@amzn/kepler-media-controls": "^1.0.8",
"@amzn/kepler-media-content-launcher": "^2.0.0",
"@amzn/kepler-ui-components": "^2.0.2",
"@amzn/keplerscript-appstore-iap-lib": "~2.12.2",
"@amzn/keplerscript-epg": "^2.4.0",
"@amzn/keplerscript-react-native-reanimated": "^2.0.1731106252",
"@amzn/keplerscript-turbomodule-api": "^1.0.0",
"@amzn/package-manager-lib": "~1.0.0",
"@amzn/react-linear-gradient": "^2.0.1746661155",
"@amzn/react-native-device-info": "^2.0.1746661155",
"@amzn/react-native-fast-image": "^2.0.1746661155",
"@amzn/react-native-gesture-handler": "^2.0.1731106252",
"@amzn/react-native-kepler": "~2.0.0",
"@amzn/react-native-safe-area-context": "~2.0.0",
"@amzn/react-native-screens": "~2.0.0",
"@amzn/react-native-svg": "^2.0.1746661155",
"@amzn/react-native-w3cmedia": "^2.1.68",
"@amzn/react-navigation__core": "~2.0.0",
"@amzn/react-navigation__drawer": "~2.0.0",
"@amzn/react-navigation__native": "~2.0.0",
"@amzn/react-navigation__routers": "~2.0.0",
"@amzn/react-navigation__stack": "~2.0.0",
"@react-native-async-storage/async-storage": "npm:@amzn/react-native-async-storage__async-storage@~2.0.0",
"@segment/analytics-react-native": "^2.20.0-beta.0",
"@segment/analytics-react-native-plugin-kepler": "file:segment-analytics-react-native-plugin-kepler-0.4.0.tgz",
"@shopify/flash-list": "1.8.3",
"@tanstack/react-query": "5.64.0",
"axios": "^1.6.7",
"date-fns": "^4.1.0",
"expo": "~50.0.0",
"graphql": "^16.8.1",
"graphql-request": "7.1.2",
"i18next": "^23.8.2",
"lodash.get": "^4.4.2",
"react": "18.2.0",
"react-i18next": "^14.0.1",
"react-native": "0.72.0",
"react-native-gesture-handler": "npm:@amzn/react-native-gesture-handler@~2.0.0",
"react-native-render-html": "6.3.4",
"react-native-svg": "npm:@amzn/react-native-svg@~2.0.1722663255",
"react-native-uuid": "^2.0.1",
"use-debounce": "^10.0.3",
"zustand": "^4.5.0"
},
"resolutions": {
"metro": "0.76.5",
"@types/react": "^18"
},
"devDependencies": {
"@amzn/kepler-cli-platform": "^0",
"@amzn/kepler-performance-api": "^0.0.1",
"@babel/core": "~7.22.8",
"@babel/plugin-transform-private-methods": "^7.27.1",
"@babel/runtime": "~7.22.8",
"@react-native-community/cli": "11.3.2",
"@react-native-community/eslint-config": "~2.0.0",
"@react-native/eslint-config": "~0.72.2",
"@react-native/metro-config": "^0.72.6",
"@testing-library/react-native": "^11.5.4",
"@types/crypto-js": "^4.2.2",
"@types/jest": "~28.1.8",
"@types/react": "^18.0.24",
"@types/react-native-dotenv": "^0.2.2",
"@types/react-test-renderer": "^18.0.0",
"@typescript-eslint/eslint-plugin": "^5.62.0",
"@typescript-eslint/parser": "^5.62.0",
"babel-jest": "~28.1.3",
"babel-plugin-transform-remove-console": "^6.9.4",
"concurrently": "^8.2.2",
"eslint": "~8.57.0",
"eslint-config-airbnb": "^19.0.4",
"eslint-config-airbnb-typescript": "^16.2.0",
"eslint-import-resolver-typescript": "^2.4.0",
"eslint-plugin-import": "^2.24.2",
"eslint-plugin-jest": "^26.0.0",
"eslint-plugin-jsdoc": "^46.8.2",
"eslint-plugin-jsx-a11y": "^6.4.1",
"eslint-plugin-oxlint": "0.1.0",
"eslint-plugin-react": "^7.25.1",
"eslint-plugin-react-hooks": "^4.3.0",
"eslint-plugin-simple-import-sort": "^5.0.3",
"husky": "^9.0.11",
"i18next-resources-for-ts": "^1.5.0",
"jest": "~28.1.3",
"lint-staged": "^15.2.10",
"metro-react-native-babel-preset": "~0.76.9",
"npm-run-all": "^4.1.5",
"patch-package": "^8.0.0",
"plop": "^4.0.1",
"prettier": "^2.8.8",
"react-native-dotenv": "~3.4.11",
"react-test-renderer": "18.2.0",
"ts-jest": "~28.0.8",
"typescript": "~4.9.5"
},
"engines": {
"node": "18.19.0"
},
"kepler": {
"projectType": "application",
"appName": "prendetv",
"targets": [
"tv"
],
"api": 0.1
}
}
