Over a million developers have joined DZone.

Creating a Maven Archetype

DZone's Guide to

Creating a Maven Archetype

Read this tutorial in order to learn how to create a Maven archetype from an existing project. This person uses Eclipse IDE to create the Maven project.

· Integration Zone ·
Free Resource

WSO2 is the only open source vendor to be named a leader in The Forrester Wave™: API Management Solutions, Q4 2018 Report. Download the report now or try out our product for free.


Many times we need to create a Maven archetype to distribute the project template. Here in this article, I am going to describe how easy it is to create a Maven archetype from an existing project.

Create a Maven Project

First of all, let's create a very simple Maven project. I am using Eclipse IDE to create the Maven project. Here is the pom.xml file of the project:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
            <name>Porua Repository</name>

Now go to the root directory of the project and execute the following commands in sequence:

  • mvn archetype:create-from-project

This command will generate the archetype from the existing Maven project. You can check the generated files at the following location:


Image title

Now at this point, you can do two more important things:

  • Modify the target/generated-sources/archetype/pom.xml to add extra things if you need
  • Modify target/generated-sources/archetype/src/main/resources/META-INF/maven/archetype-metadata.xml to include/exclude files etc in the archetype. (Please read Maven's official documents for more information)

mvn clean install

Execute this command on target/generated-sources/archetype/pom.xml. It will install the plugin in your local repository.

mvn archetype:generate -DarchetypeCalalog=local

Execute this command to check your archetype available in the local repository.

Using The Archetype

At this point, our archetype is installed successfully in our local Maven repository. Let's try to make use of it. Use this command to make a project from the archetype:

mvn -B archetype:generate \
-DarchetypeGroupId=com.porua \
-DgroupId=com.mycompany.app \


That's it. It's very simple to create a Maven archetype from an existing project.

IAM is now more than a security project. It’s an enabler for an integration agile enterprise. If you’re currently evaluating an identity solution or exploring IAM, join this webinar.

maven 3.5.0 ,integration ,maven archetype ,maven

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}