Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Get Started
Design and Develop
Publish
Reference
Support
Native
Skip to main content
Vega Studio is an extension for Visual Studio Code (VS Code) and Kiro. It includes these tools:
  • Integrated debugging tools
  • Real-time performance monitoring
  • Built-in app optimization features
  • Direct device management for Fire TV Stick
  • Testing capabilities
When you install the Vega SDK, the installer automatically configures Vega Studio in VS Code. If you use Kiro, install Vega Studio manually. Vega Studio gives you access to all Vega development tools and commands from the command palette in VS Code or Kiro.

Verify your setup

  1. Open VS Code or Kiro, and look for the Vega extension icon in the activity bar.
  2. To check your installed extensions, go to Code > Settings > Extensions (VS Code) or Kiro > Settings > Extensions (Kiro), and enter “Vega Studio” in the Extensions: Marketplace search field. If you see the Vega extension icon, continue to Build Your App, or explore the Vega Studio panel and advanced configuration options. If you don’t see the Vega extension icon, continue to Install Vega Studio manually.

Install Vega Studio manually

Choose one of these installation options: Microsoft Marketplace, the Vega SDK, or the Open VSX Registry (for Kiro).

Option 1: Install from Microsoft Marketplace

  1. On the extension page, select Install.
  2. Select Open Visual Studio Code.
  3. If prompted, select Continue.
  4. Confirm that the Vega extension icon appears in the activity bar.

Option 2: Install from Vega SDK

  1. Open a terminal, and run the following command:
  2. If prompted, select Reload.
  3. Confirm that the Vega extension icon appears in the activity bar.

Option 3: Install in Kiro from Open VSX Registry

  1. Go to the Vega Studio extension page on the Open VSX Registry.
  2. Select Download.
  3. Select the architecture that matches your system.
  4. Open Kiro .
  5. To open the command palette, choose the settings icon > Command Palette…, or press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Linux).
  6. Enter Extensions: Install from VSIX…, and then select the command.
  7. Select the .vsix file that you downloaded in step 3.
  8. Confirm that the Vega extension icon appears in the activity bar.

Explore the Vega Studio panel

After you install Vega Studio, you can access all its development tools from the Vega Studio panel.
  1. Open VS Code or Kiro.
  2. Look for the Vega extension icon in the activity bar.
  3. Select the Vega extension icon to open the Vega Studio panel, which contains the following sections:
    • Projects: Create, manage, and organize your development projects
    • Build Modes: Configure debug and release build settings
    • Devices: Manage and monitor connected devices
    • SDK Manager: Install, view, and switch between SDK versions
    • App Performance Tools: Monitor and optimize app performance
    • Help and Feedback: Access documentation and tutorials, and submit support requests

Manage your Vega projects

The Projects section lists your current projects with options to build, install, or run them. Screenshot of the Projects section in the Vega Studio panel showing a list of current projects with build, install, and run options.

Select your build mode

The Build Modes section lets you choose between Debug and Release builds for your Vega app. Your selection applies to all later builds until you change it. Screenshot of the Build Modes section showing the Debug and Release toggle options for configuring your Vega app build.

Debug mode

Debug mode is for development and testing. It includes debugging artifacts and enables the Metro Packager (React Native’s JavaScript bundler), which supports real-time code updates through Fast Refresh. Vega Studio automatically enables Fast Refresh when you use Debug mode. To use Fast Refresh:
  1. Build your app in Vega Studio.
  2. Run your app on Vega Virtual Device or a Fire TV device.
  3. Change your code, and confirm that the changes appear on your device.

Release mode

Release mode creates optimized, production-ready code for deployment and publishing. It disables development features such as Fast Refresh, removes debugging information, and reduces file size to improve runtime performance.

View your devices

The Devices section shows all virtual and physical devices connected to your computer. The device list updates automatically when you connect or disconnect a device. To run your project, select a device. Screenshot of the Devices section in the Vega Studio panel showing the context menu of available options for a connected device. From the device context menu, you can start a virtual device. Screenshot showing how to start a virtual device from the context menu on a device listing in the Devices section. You can also open a terminal session to interact with a device directly. Screenshot of the Devices section showing the context menu option that opens a terminal session for a connected device.

Install the Vega SDK manager to switch versions

The SDK Manager section lets you install a new SDK version, view installed SDK versions, or switch between installed versions. Screenshot of the SDK Manager section in the Vega Studio panel showing installed SDK versions and the options to install a new version or switch versions. To install a new SDK version:
  1. Select the SDK Manager section in the Vega Studio panel.
  2. Select Install New SDK or the + icon next to an available version.
  3. Wait for the installation to complete.
To switch SDK versions:
  1. Select the SDK Manager section in the Vega Studio panel.
  2. Select the version you want to activate.
  3. When prompted, reload VS Code or Kiro.
You can also manage SDKs from the command palette. For a full list of SDK Manager commands, see Vega Studio Commands.

Access performance monitoring tools

The App Performance Tools section provides tools to monitor and optimize your app’s performance. Some tools are available only when your app runs on a physical device. Screenshot that shows the performance monitoring and debugging tools in the App Performance Tools section.
  • Activity Monitor: Monitors app memory and CPU usage in real time
  • Memory Monitor: Monitors app memory usage in real time
  • App KPI Visualizer: Measures key performance indicators (KPIs) and verifies whether your app meets the performance standard
  • Chrome Dev Tools: Inspects, debugs, and profiles your app as an alternative to the built-in VS Code debugger

Submit feedback or issues, find resources and guides

The Help and Feedback section provides these links:
  • Feedback: Lets you submit feedback or issues to the Vega team
  • Documentation: Links to resources for getting started with Vega development
  • Walkthrough: Provides guides for project setup, build modes, device management, and performance tools
  • Create bug report: Gathers diagnostic information about your system, devices, and logs
Screenshot of the Help and Feedback section showing the available resources, such as Feedback, Documentation, Walkthrough, and Create Bug Report. The Create bug report link opens the Bug Report tool, which gathers diagnostic information about your system, devices, and logs. The tool saves this information to a file that you can attach to a support ticket. The report includes: System information
  • Operating system details (platform, version, architecture)
  • Hardware information (memory, CPU)
  • Environment details (Node.js version, SDK version)
Device information
  • List of connected Vega devices
  • Device details (type, OS, architecture)
  • Device status information
Log files
  • Vega Studio extension logs
  • React Native app logs
  • Vega SDK logs
  • Device logs (for connected devices)
  • Latest aggregated crash report (ACR) from the device

Protect your privacy

Before you submit a bug report, review the entire file. It might contain personal information, such as usernames, home directory paths, file paths, or other sensitive data. Remove any private information before you submit the report.

When to create a bug report

Create and submit a bug report when:
  • Vega Studio shows errors or unexpected behavior
  • Vega Studio crashes or freezes
  • Features don’t work as expected
  • Vega Virtual Device or a physical device crashes

How to create a bug report

  1. In Vega Studio, open the Help and Feedback section.
  2. Choose Create Bug Report. Vega Studio does the following:
    • Generates a bug report file (this might take a minute)
    • Saves the file to your home directory
    • Shows the file location
    • Opens the Appstore Developer Support page
  3. On the Appstore Developer Support page, fill out the form.
  4. Attach the bug report file to your support ticket (10 MB size limit).
If Vega Studio fails to generate the report:
  1. Restart VS Code or Kiro.
  2. Repeat steps 1–4.

Need help?

Use these resources to resolve issues or find answers:
  • Create a support case to get direct help from Amazon support
  • Use DevAssistant to find the information you need
  • Search the community forum for solutions from other developers

Configure advanced options

Vega Studio provides advanced settings that customize the extension’s behavior for your workflow.

Automatic device detection

Vega Studio automatically updates the device list to show connection status in real time. Screenshot of the Vega Studio extension settings showing the Features: Automatic Device Detection checkbox, which turns real-time device list updates on or off. To turn automatic device detection on or off:
  1. Go to Extensions > Vega Studio.
  2. Go to Vega > Features: Automatic Device Detection.
  3. Select the checkbox to turn on the feature, or clear the checkbox to turn it off.

Build target architecture optimization

Vega Studio optimizes builds by creating artifacts only for your target device architecture, which reduces build times and package sizes. Screenshot of the Build Target Architecture Optimization checkbox in the Vega Studio extension settings panel. For example, when you target Fire TV Stick:
  • Included: armv7 artifacts
  • Excluded: x86_64 and aarch64 artifacts
To turn build target architecture optimization on or off:
  1. Go to Extensions > Vega Studio > Settings.
  2. Go to Vega > Features: Build Target Architecture Optimization.
  3. Select the checkbox to turn on the feature, or clear the checkbox to turn it off.

Launch options

Vega Studio lets you configure parameters for the launch app command in VS Code or Kiro. To configure launch options:
  1. Open settings:
    • Mac: Code > Settings > Settings (VS Code) or Kiro > Settings > Settings (Kiro)
    • Linux: File > Preferences > Settings
  2. Choose the scope for your settings:
    • User: Applies to all projects for the current user
    • Workspace: Applies to all projects in the workspace
    • Project: Applies to a specific project
    In the following example, the Workspace scope is selected. Screenshot of the Settings editor with the Workspace scope selected, showing where to set project launch options for the Vega Studio extension.
  3. Go to Extensions > Vega Studio.
  4. In the Vega Launch Options section, enter your launch options.

Monorepo support

Vega Studio supports monorepo layouts through npm and Yarn workspaces (v0.20+). For setup instructions, configuration options, and troubleshooting, see Set Up Monorepo Support.

Next steps


Last modified on October 29, 2026