# Getting Started with the KendoReact Layout

This guide provides essential information about using the KendoReact Layout package—you will learn how to install the package, add a PanelBar component to your project, style the component, and activate your license. The steps demonstrated in this guide are applicable to all KendoReact Layout components.

<div data-component="StartKendoReactFreeSection"></div>

After completing this guide, you will be able to reproduce the following example.

[Demo Source](https://demos.telerik.com/kendo-react-ui/layout/get-started/func/source.txt)

## Before You Begin

To follow the steps in this guide, you need to have a React project set up. If you don't have one, you can create a new React application using Vite by running the following command in your terminal:

```sh
npm create vite@latest my-app -- --template react-ts
```

This guide requires that you have **basic knowledge of React and TypeScript**, and that you have already created [**a blank React project**](https://www.telerik.com/kendo-react-ui/components/getting-started).

> tip You can speed up the development of your KendoReact application with the [Kendo UI Template Wizard for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=KendoUI.kendotemplatewizard).

## Install the Component

Navigate to the root folder of your React project and run the following command:

```sh
npm i @progress/kendo-react-layout @progress/kendo-theme-meridian
```

Run these commands in the root of your React project to install the KendoReact Layout package and its [dependencies](https://www.telerik.com/kendo-react-ui/components/layout/get-started#kendoreact-layout-dependencies), and the Kendo UI [Meridian theme](https://www.telerik.com/design-system/docs/themes/kendo-themes/meridian/).

## Import the Component

After installing the Layout package, import the desired components in the React App.

In the `src/App.tsx` file of your React project, import the PanelBar component from the Layout package. To use [items](https://www.telerik.com/kendo-react-ui/components/layout/panelbar/items/items) in the PanelBar, add the [PanelBarItem](https://www.telerik.com/kendo-react-ui/components/layout/api/panelbaritemprops) component as well.

```tsx
import { PanelBar, PanelBarItem } from '@progress/kendo-react-layout';
```

Place the `import` statements in the App component file (for example: `src/App.tsx`) for your project.

## Use the Component

1. After installing the Layout package and importing the components, add the tags of the desired components to the `src/App.tsx` file in your project.

   ```tsx
   const App = () => {
       return (
           <PanelBar>
               <PanelBarItem title={'Teams'}>
                   <PanelBarItem title={'Team 1'} />
                   <PanelBarItem title={'Team 2'} />
               </PanelBarItem>
               <PanelBarItem title="Releases">
                   <PanelBarItem title="Q1 2021" />
                   <PanelBarItem title="Q2 2021" />
               </PanelBarItem>
           </PanelBar>
       );
   };

   export default App;
   ```

2. Build and run the application by typing the following command in the root folder of your project:

   ```sh
   npm run dev
   ```

3. Navigate to [http://localhost:5173](http://localhost:5173/) to see the KendoReact PanelBar component on the page.

## Style the Component

> tip Are you looking for guidance around how to create visually appealing and consistent user interfaces with Telerik UI components? Check out the [Progress Design System](https://www.telerik.com/design-system/docs/).

To use the built-in styling of the components, start by installing a theme:

```sh
npm i @progress/kendo-theme-meridian
```

Import the CSS file from the package in `src/App.tsx`. Add this import before your existing `App.css` import:

```jsx
import '@progress/kendo-theme-meridian/dist/all.css';
```

With this import in place, you already have professionally designed styling applied to your app out-of-box. You can also try any of the other available [Kendo UI Themes](https://www.telerik.com/design-system/docs/themes/get-started/introduction/#available-themes).

## Next Steps

Now try to add another component from the Layouts package yourself. The procedures for [installing](https://www.telerik.com/kendo-react-ui/components/layout/get-started#install-the-component), [importing](https://www.telerik.com/kendo-react-ui/components/layout/get-started#import-the-component), and [using](https://www.telerik.com/kendo-react-ui/components/layout/get-started#use-the-component) the layout components are identical for all components in the package.

The Layout package provides the following components:

* [AppBar](https://www.telerik.com/kendo-react-ui/components/layout/appbar)
* [Avatar](https://www.telerik.com/kendo-react-ui/components/layout/avatar)
* [BottomNavigation](https://www.telerik.com/kendo-react-ui/components/layout/bottomnavigation)
* [BreadCrumb](https://www.telerik.com/kendo-react-ui/components/layout/breadcrumb)
* [Card](https://www.telerik.com/kendo-react-ui/components/layout/card)
* [ContextMenu](https://www.telerik.com/kendo-react-ui/components/layout/contextmenu)
* [Drawer](https://www.telerik.com/kendo-react-ui/components/layout/drawer)
* [ExpansionPanel](https://www.telerik.com/kendo-react-ui/components/layout/expansionpanel)
* [GridLayout](https://www.telerik.com/kendo-react-ui/components/layout/gridlayout/items)
* [Menu](https://www.telerik.com/kendo-react-ui/components/layout/menu)
* [PanelBar](https://www.telerik.com/kendo-react-ui/components/layout/panelbar)
* [Splitter](https://www.telerik.com/kendo-react-ui/components/layout/splitter) (premium)
* [StackLayout](https://www.telerik.com/kendo-react-ui/components/layout/stacklayout)
* [Stepper](https://www.telerik.com/kendo-react-ui/components/layout/stepper)
* [Tabstrip](https://www.telerik.com/kendo-react-ui/components/layout/tabstrip)
* [TileLayout](https://www.telerik.com/kendo-react-ui/components/layout/tilelayout)
* [Timeline](https://www.telerik.com/kendo-react-ui/components/layout/timeline) (premium)

## KendoReact Layout APIs

[Layout API](https://www.telerik.com/kendo-react-ui/components/layout/api)

## KendoReact Layout Dependencies

The Layout package requires you to install the following [peer dependencies](https://nodejs.org/en/blog/npm/peer-dependencies/) in your application:

| Package Name                       | Description                                                                                                                                                                 |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| react 18.0.0\*                     | Contains the functionality necessary to define React components.                                                                                                            |
| react-dom                          | Contains the React renderer for the web.                                                                                                                                    |
| @progress/kendo-licensing          | Contains the internal infrastructure related to licensing.                                                                                                                  |
| @progress/kendo-react-progressbars | Contains the KendoReact ProgressBar component.                                                                                                                              |
| @progress/kendo-react-intl         | Contains the KendoReact Internationalization package that applies the desired cultures by providing services and pipes for the parsing and formatting of dates and numbers. |
| @progress/kendo-svg-icons          | Contains the KendoReact SVG icons.                                                                                                                                          |
| @progress/kendo-react-animation    | Enables the animations in the KendoReact components.                                                                                                                        |
| @progress/kendo-react-buttons      | Contains the KendoReact Button components.                                                                                                                                  |
| @progress/kendo-react-common       | Contains common utilities that enhance the performance and functionalities of the KendoReact UI components.                                                                 |
| @progress/kendo-react-popup        | Contains positioning logic for the Popup component.                                                                                                                         |
| @progress/kendo-react-progressbars | Contains the KendoReact ProgressBar component.                                                                                                                              |

## Activating Your License Key

**Important**: The KendoReact Layout components have both free and premium features. Only the premium features require a license key file to be installed in your project:

* **Trial usage**: [Start a free trial](https://www.telerik.com/try/kendo-react-ui) and download a trial license key file
* **Commercial usage**: [Purchase a license](https://www.telerik.com/kendo-react-ui/pricing) and download a commercial license key file

Without a valid license key file, the premium features will display licensing warnings and watermarks.

Follow the instructions on the KendoReact [My License page](https://www.telerik.com/kendo-react-ui/components/my-license) to download and install your license key file. You can skip this step if your application already contains a KendoReact license file.

## Suggested Links

* [Virtual Classroom (Introductory Course Available to Trial and Commercial License Holders)](https://learn.telerik.com/learn/course/external/view/elearning/14/kendoreact)
* [Explore the Finance Portfolio Sample Application](https://www.telerik.com/kendo-react-ui/components/sample-applications/finance-application/)
* [Explore the Coffee Warehouse Sample Application](https://www.telerik.com/kendo-react-ui/components/sample-applications/react-coffee-warehouse-dashboard/)
* [Explore the GitHub Issues Grid Sample Application](https://www.telerik.com/kendo-react-ui/components/sample-applications/issues-grid/)
