Documentation versions (currently viewingVaadin 14)

You are viewing documentation for an older Vaadin version. View latest documentation

Starting a Project

In this article, we go through creating or importing a new Vaadin project in NetBeans, and running it.

With NetBeans, you can create a project:

  • Externally, using an application wizard or a Maven archetype, and then importing it to NetBeans.

  • Creating from a Maven archetype in NetBeans.

Maven is a project management tool that goes beyond dependency management. See Learning Maven Concepts for more.

Importing the Project

  1. In NetBeans, select File  Open Project…​.

  2. Select the folder containing the Maven project you want to import.

    Open project

  3. Click Open Project to complete the process.

Running Maven Goals

NetBeans has integration with Maven, enabling you to run Maven commands. Besides building and cleaning the project, you can run the web application in an embedded web server.

  1. Select the project in the Projects view.

    NetBeans will show common Maven goals inside the Navigator view:

    Navigator view

  2. Double-click a goal to execute it.

Running the Web Application

You can run the web application in an embedded web server by running the appropriate goal for your technology stack.

Technology Stack Embedded Server Goal to Run

Spring Boot


CDI / Java EE

Apache TomEE


Plain Java



While the server is running, you can edit and save any source files, and the server notices the change and redeploys web application. You can also enable Live Reload.

To stop the server, click the stop button in the Output view:

Output view

Binding Maven goals to IDE actions

As running the web application is a frequent task during development, you may want to bind such Maven goal to an IDE action.

To associate the Run project action to a Maven goal to start the server, do as follows:

  1. Right-click the project in the Projects view and select Properties.

  2. In the Project Properties window, select Categories  Actions.

  3. Select the Actions  Run project option.

  4. Type the goal to start the web server in Execute Goals: either jetty:run (plain Java project), tomee:run (CDI project), or spring-boot:run (Spring Boot project).

  5. Click OK:


Now you can deploy and run the web application by clicking the run icon in the toolbar:


You can repeat the process to bind the same Maven goal to the Debug project IDE action as well.

If the Vaadin application was created with the project wizard or a Maven archetype, you should be able to access it at http://localhost:8080.

With the above configuration, you can now use NetBeans to develop your Vaadin application with Maven.

To learn more about: