Starting a Project
You can use a Maven archetype to generate a Vaadin web application with a preconfigured Jetty Maven Plugin in it. Once created, you can import it in your IDE.
Most IDEs support creating a project from a Maven archetype. Please see your IDE and its documentation for instructions.
On command-line, you can generate a project as follows:
>---- mvn -B archetype:generate \ -DarchetypeGroupId=com.vaadin \ -DarchetypeArtifactId=vaadin-archetype-application \ -DarchetypeVersion=14.12.3 \ -DgroupId=org.example \ -DartifactId=my-webapp \ -Dversion=1.0-SNAPSHOT
The parameters are as follows:
[parameter]#archetypeGroupId#::
The group ID of the archetype is `com.vaadin` for Vaadin archetypes.
[parameter]#archetypeArtifactId#:: The archetype ID.
There is currently one archetype, `vaadin-archetype-application`.
[parameter]#archetypeVersion#::
Version of the archetype to use.
`LATEST` selects the latest version.
For prerelease versions it should be the exact version number, such as `15.0.0.beta2`.
[parameter]#groupId#::
A Maven group ID for your project.
It is normally your organization domain name in reverse order, such as `com.example`.
The group ID is also used as a prefix for the Java package in the sources, so it should be Java compatible - only alphanumerics, and an underscore.
[parameter]#artifactId#::
Identifier of the artifact, that is, your project.
The identifier may contain alphanumerics and underscore.
It is appended to the group ID to obtain the Java package name for the sources.
For example, if the group ID is `com.example` and artifact ID is `myproject`, the project sources would be placed in `com.example.myproject` package.
[parameter]#version#::
Initial version number of your application.
The number must obey the Maven version numbering format.
Creating a project can take a while as Maven fetches all the dependencies.
== Exploring the Project
The project will look as follows in a file browser:
.Maven project directory.
image::images/eclipse/maven-project-directory.png[Maven project directory]
You are now ready to import the project in your IDE.
Please see the instructions for your IDE in <<eclipse#getting-started.eclipse.importing, Importing a Project in the Eclipse IDE>>, <<eclipse#getting-started.eclipse.importing, Importing a Project in IntelliJ>>, or <<netbeans#getting-started.netbeans.importing, Importing a Project in NetBeans>>.
[discussion-id]`E463CB25-83AB-48FE-BA32-1F93726A2D9A`