= HelloWorld :toc: :toc-placement!:

This is a minimal link:https://causeway.apache.org[Apache Causeway] application, intended as a starting point to learn what the framework is all about.

[TIP]

For real-world development, we recommend you instead start with the link:https://github.com/apache/causeway-app-simpleapp[SimpleApp] starter app.

It provides more structure and includes examples of fixtures, unit tests, integration tests, and BDD (Cucumber) specs.

toc::[]

== Quick start

• install prereqs:

** Java 21 LTS (eg link:https://adoptopenjdk.net/[Adopt OpenJDK] distribution) ** Maven 3.9.11 or later (http://maven.apache.org/download.cgi[download])

• download and unzip

[source,bash]

APP=helloworld BRANCH=master

REPO=causeway-app-$APP curl "https://codeload.github.com/apache/$REPO/zip/$BRANCH" | jar xv mv $REPO-$BRANCH $REPO cd $REPO

• Build using Maven:

[source,bash] .build.sh

mvn clean install

• Run using Maven:

[source,bash] .run.sh

mvn spring-boot:run

• Browse to http://localhost:8080.

• Login using:

** username: sven ** password: pass

The app runs with H2 running in-memory.