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

SnapLogic is the leading self-service enterprise-grade integration platform. Download the 2018 GartnerMagic Quadrant for Enterprise iPaaS or play around on the platform, risk free, for 30 days.


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.

Download A Buyer's Guide to Application and Data Integration, your one-stop-shop for research, checklists, and explanations for an application and data integration solution.

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 }}