> Markdown version of [Getting Started](https://vaadin.com/docs/v23/tools/swing/getting-started). Section index: [llms.txt](https://vaadin.com/docs/v23/tools/llms.txt)

# Getting Started with Swing Kit

## <a id="requirements"></a>1. Requirements

You need the following to use Swing Kit:

- a Vaadin Flow application, using Vaadin 23 or newer;

- a Swing application running with Java 8 or newer;

- a Maven build system.

## <a id="maven-setup"></a>2. Maven Setup

1. Add the following dependency to your Vaadin Flow application:

   ```xml
   <dependency>
       <groupId>com.vaadin</groupId>
       <artifactId>vaadin-swing-kit-flow</artifactId>
       <version>1.0.0</version>
   </dependency>
   ```

2. Add the following dependency to your Swing application:

   ```xml
   <dependency>
       <groupId>com.vaadin</groupId>
       <artifactId>vaadin-swing-kit-client</artifactId>
       <version>1.0.0</version>
   </dependency>
   ```

## <a id="swing-application-configuration"></a>3. Swing Application Configuration

On macOS and Linux, the following JVM parameters must be added to run the Swing application:

```
--add-opens java.desktop/sun.awt=ALL-UNNAMED
--add-opens java.desktop/sun.lwawt=ALL-UNNAMED
--add-opens java.desktop/sun.lwawt.macosx=ALL-UNNAMED
```

> **Note: Access to the system home folder is required**
>
> The rendering process stores a file in the home folder of the system, which is downloaded from the internet, if not already present. This happens the first time you run the Swing application.
