Getting started

In this short getting started document we will learn how to create and setup a project for domino-ui.

Let's create your first domino-ui project, steps below will guide you through the whole process it will only take you less than 5 minutes!

Create a Domino-ui Project

---

There is more than one way to create a new domino-ui project and we will go through them all

Method 1: Create project from domino-ui archetype:

Prerequisites

• Java
• Maven

Steps

• Crate a new folder for the project, this could be any empty folder
• Open a terminal in the created folder
• Execute the below command, it will create a new domino-ui project.

 mvn archetype:generate \
	-DarchetypeGroupId=org.dominokit.archetypes \
	-DarchetypeArtifactId=domino-ui-archetype \
	-DarchetypeVersion=1.0-SNAPSHOT

While executing, it will ask you to fill some values : groupId, artifactId, version, package

• Once the last commands complete cd into the generated project folder, the folder name is the artifact name you entered in the previous step.
• Execute the command : mvn clean install.

Run the generated project

Execute the below commands each in different terminal:

mvn tomcat7:run -pl *-server -am -Denv=dev

this command will start the application server

mvn gwt:codeserver -pl *-client -am

this command will start gwt super dev mode.

You can run both commands in one terminal:

mvn tomcat7:run -pl *-server -am -Denv=dev | mvn gwt:codeserver -pl *-client -am

find more information about this archetype and the run commands here

OR

Run the application using the shell script included in the generated project

In project root folder make sure the file run.sh is executable then execute

./run.sh

Access the application at :

localhost:8080