IntelliJ IDEA 2017.2 Help

Getting Started with Vaadin-Maven Project

This feature is supported in the Ultimate edition only.

IntelliJ IDEA lets you create and manage a Maven project with Vaadin archetype.

Creating Maven project with Vaadin archetype

  1. Open Project Wizard, under Maven, select Create from archetype check box and click Add archetype.
  2. In the dialog that opens, enter maven GroupId, ArtifactId and Version.
    create maven vaadin arch
  3. After you click OK, the Vaadin archetype is added to the list of available archetypes. Click Next.
    vaadin archetype added
  4. On the next page of the wizard, enter maven information for your project and click Next.
    vaadin maven gr id
  5. On the next page of the wizard, enter maven settings for your project and click Next.
    vaadin maven info
  6. On the next page of the wizard, enter your project's information and click Finish.
    vaadin maven project info

IntelliJ IDEA creates a maven project with pom.xml. IntelliJ IDEA also recognizes that this is a Web application and creates a webapp in your source directory.

Import an external Vaadin project with Maven

You can import external Vaadin project using VCS and check out your project from, for example, Git. In this case IntelliJ IDEA automatically converts your project structure, detects necessary frameworks and downloads appropriate dependencies.

  1. In the Project Wizard, click Check out from Version Control and from the drop-down list, select Git.
    vaadin maven git
  2. Specify Git Repository from which you want to clone your project, a Parent Directory location and the name of the parent directory. Click Clone.
    vaadin maven clone rep

    IntelliJ IDEA copies git project to your local directory, recognizes POM file, meaning it recognizes that this is a Maven project with Vaadin framework and imports the project with all the necessary configurations.

    vaadin maven cvs
  3. Check project structure to make sure that all necessary dependencies are downloaded.
    vaadin maven proj str
    The frameworks are configured automatically, so you can exclude the detected ones.
    vaadin maven facet detection

Configure run/debug settings and run application

IntelliJ IDEA lets you quickly configure Run/Debug settings for your project.

  1. On the main menu, select Run | Edit Configurations.
  2. Click new to add a new configuration from the list, specify the appropriate parameters for your configuration and press OK.
    vaadin maven run debug conf
  3. On the main menu press run to run the application.

You can view the output in the default browser http://localhost:8080/.

Last modified: 29 November 2017