Get Started with the Vega UI Component Library

Open Beta Documentation Amazon offers this technical documentation as part of a pre-release, open beta. The features described might change as Amazon receives feedback and iterates on the features. For the most current feature information, see the Release Notes.

Vega UI Components (VUIC) are a collection of reusable, customizable, and performant components to help you build apps with Vega. VUIC includes several actively maintained components (Carousel, EPG, Seekbar) and additional experimental components. Existing users may continue to utilize these experimental features at their discretion. Please note, documentation for these experimental components is not currently accessible for new developers.

Prerequisites

Before installing VUIC, make sure you installed the Vega SDK on your local machine. See Install the Vega SDK.

Installation

VUIC is available as an NPM package in the same repository, like Vega packages. Navigate to your project's root directory and install VUIC as shown below.

Copied to clipboard.

npm install @amazon-devices/kepler-ui-components@~2.0.0

To confirm a successful installation, open the app's package.json. In the dependencies section, you should see the VUIC library, such as the example below.

Copied to clipboard.

"dependencies": {
    // ...
    "@amazon-devices/kepler-ui-components": "~2.0.0",
}

You can verify the presence of VUIC in the NPM repo with the following command.

Copied to clipboard.

$ npm search '@amazon-devices/' --registry $(npm config get @amazon-devices:registry)

Usage

After you install the VUIC package, you can import the library into your code. Here is an example with the Carousel component.

Copied to clipboard.

import React from 'react';
import { Carousel } from '@amazon-devices/kepler-ui-components';

Carousel updates

Upgrading to the >2.0.0 version of the library contains major changes to Carousel, which might cause existing apps using that component to crash. See the Carousel documentation to learn how to troubleshoot and migrate to the latest version.

Last updated: Sep 30, 2025