Create a Hello World App - Amazon Vega Docs

This tutorial walks you through creating, building, and running your first Vega app using Vega Studio, the Vega SDK’s VS Code extension. This example creates an app called VegaProject based on a React Native app template and runs in the Vega Virtual Device, a simulated Fire TV Stick included in the Vega SDK. If you want to explore all build options, such as using the Vega CLI and additional app templates, see Build Your App.

Prerequisites

Install the Vega SDK. The SDK includes the tools for you to create, build, and run your apps.
Open Visual Studio Code or download it.

Build a Hello World app

Step 1: Create a new app from a Vega template

In VS Code, select the Vega extension icon in the activity bar.
Click the + icon to create a new project.
Select the template helloWorld (React Native 0.83-based template).
Choose a project directory or create a new one, then open it.
Name the project, package, and press Enter after each. This example uses the following names: App name: VegaProject Package name: com.myorg.VegaProject
A workspace prompt appears. Name and save your workspace to a location of your choice.

Step 2: Build the app in test mode

In the Vega extension, locate and select the VegaProject in your workspace.
Set build mode to Debug. This enables fast-refresh by default, so any saved changes to your app are reflected on your app in real-time.
Select the build button next to VegaProject.

Check the Output tab in VS Code for the build success message.

2025-12-16 15:07:44.151 [info] [native-build] kepler ktbuild exited with code 0
2025-12-16 15:07:44.198 [info] info build-kepler completed

Step 3: Run in Vega Virtual Device (VVD)

Run the app in Vega’s Fire TV Stick simulator, the Vega Virtual Device (VVD).

In the extension panel, locate VirtualDevice:Tv under Devices and press the Play button.
Wait for the VVD window to open.
Select the Play button next to VegaProject.

When the app runs, you see the VVD update with the Hello World app.

This is a screenshot of the Vega Virtual Device interface — Vega's Hello World app template in the VVD

Congratulations! You’ve successfully created and run your first Vega app. Try changing some of the text in your App.tsx to see the changes reflected live on the running app.

Additional resources

Now that you’ve created your first Vega app, explore these resources to learn more:

Accelerate your app development with Vega’s sample apps.
Complete the Vega video app tutorial. The tutorial walks you through detailed steps to create a video app with the W3C Media Player.
See all build options and experiment with other templates and native modules.
Review additional development options in the documentation.

​Prerequisites

​Build a Hello World app

​Step 1: Create a new app from a Vega template

​Step 2: Build the app in test mode

​Step 3: Run in Vega Virtual Device (VVD)

​Additional resources