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 latest Release Notes.

Vega UI Components (VUIC) are a collection of reusable, customizable, and high-performance components to help you build apps with Vega. VUIC includes several actively maintained components (Carousel, EPG, Seekbar) and additional experimental components. Existing users might continue to use these experimental features at their discretion.

Note: Documentation for these experimental components isn't accessible for new developers.

Prerequisites

Before installing VUIC, make sure you installed the Vega SDK on your local machine. For more details about installation, see Install the Vega SDK.

Installation

VUIC is available as an npm package in the same repository, like Vega packages. Navigate to the root directory of your project and install VUIC with the following command.

Copied to clipboard.

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

To confirm a successful installation in your app, open package.json. In the dependencies section, you should see the VUIC library, as in the following example.

Copied to clipboard.

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

You can verify the presence of VUIC in the npm repository 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: Oct 15, 2025