---
id: awe-101
title: awe-101 Your first AWE App
sidebar_label: awe-101 Your first AWE App
---

## Introduction

This guide will show you step by step with the help of a video how to generate you first AWE web application. For this, we will use the archetype [`awe-boot-archetype`](https://search.maven.org/search?q=awe-boot-archetype).

## What we need for this tutorial?

The requirements for this example are:
* Five spare minutes :grin: 
* Your favorite IDE or text processor
* JDK 1.8 or above
* Maven 3.0+
* Archetype catalog

## Archetype catalog

In order to be able to use AWE's archetype you will need to add the next remote `Maven Central` archetype catalog:

```html
https://repo.maven.apache.org/maven2/archetype-catalog.xml
```
 

## Application generation

### With maven
You can create your first application running the following command in a terminal window using maven archetype `awe-boot-archetype` with version [![Version](https://img.shields.io/maven-central/v/com.almis.awe/awe-starter-parent.svg?label=maven%20central)](https://search.maven.org/search?q=g:%22com.almis.awe%22%20AND%20a:%22awe-starter-parent%22)
```console
./mvn -B archetype:generate \
     -DarchetypeGroupId=com.almis.awe \
     -DarchetypeArtifactId=awe-boot-archetype \
     -DarchetypeVersion=[Archetype version]
     -DgroupId=com.example.app \
     -DartifactId=my-app \
     -Dversion=1.0-SNAPSHOT 
```
Then, run your application with (**in project directory**):
```console
./mvn spring-boot:run
```
### With your favourite IDE
Below this line, you can find a video explaining how to generate our first web application using AWE and [IntelliJ IDE](https://www.jetbrains.com/en-en/idea/).

<figure className="video-container disassociated-with-next-sibling">
  <iframe src="//www.youtube.com/embed/ePxY319YnFA" style={{border:0}} allowfullscreen></iframe>
</figure>

---

:::info
You can use version **4.2.x** of AWE's archetype. Username is `test` and password is `test` for the test application.
:::