Zakadabar Application Template

This repository contains an application template which you may use to start a new application project based on Zakadabar.

NOTE: This template uses JDK 14, it doesn't work on lower versions.

Create

1. Create a new repository from this template (Use this template button).

Customize

1. Check out the new repository with IDEA.
2. Import the gradle project (optional):
   • IDEA might show you a bubble to "Load Gradle Config", or
   • Right click on build.gradle.kts in IDEA and then click on Import Gradle Project
3. Edit settings.gradle.kts:
   1. Change project name.
4. Edit build.gradle.kts
   1. Change group and version.
   2. Change parameters of the "zakadabar:zkCustomise" task:
      1. the package you would like to use,
      2. any other parameters you want to change.
5. Refresh gradle config in IDEA (optional).
6. Run the zakadabar:zkCustomize gradle task from IDEA or ./gradlew zkCustomize from a shell.

At this point you have the source code of a fully functioning application.

Run (During Development)

Note You can start the backend and/or the frontend directly from IDEAs Gradle panel. However, there is a bug in the gradle / IDEA combo that sometimes prevents two gradle tasks running at the same time. If your second task does not start, you can: 1) clear the gradle cache 2) open a terminal and issue the gradle command from the project root directory.

Default configuration creates a local H2 database. You can change this in stack.server.yaml. With H2 the first run creates the database in app/var.

Default username and password is so and so. You can change the default password before database initialization in lib.accounts.yaml.

Start the backend with:

./gradlew run

Start the frontend with:

./gradlew jsBrowserRun --continuous

The first step starts the backend server. It listens on 8080. The second step starts a webpack devserver. It listens on 3000.

The webpack dev server forwards anything that starts with '/api' to the backend server.

To reload the web page after code changes, add --continuous to the arguments of the jsBrowserRun run configuration.

Build Distributable Packages

Note: You might need to use IDEAs "Use Excluded Files" option in the "Project" panel to see the build directory.

App Package

./gradlew zkBuild

In the build/app directory you will find:

• a zip file that contains your application
• the content of the zip file extracted

Docker

./gradlew zkDocker

In the build/app directory you will find:

• a zip file that contains your application
• the content of the zip file extracted
• a docker compose file which contains a PostgreSQL server and your application

Maven Publish

To sign and publish the artifacts generated by the project to a Maven repository:

1. Define the parameters (see below) in gradle properties (~/.gradle/gradle.properties) or in environment variables.
2. Check publishing.kt for publication config.

The signing uses gpg from the operating system, check publishing.kt and the signing Gradle plugin for options.

Gradle property	Env variable	Explanation
zk.publish	ZK_PUBLISH	Configure the "publish" gradle task when not null.
zk.publish.snapshot.url	ZK_PUBLISH_SNAPSHOT_URL	URL of the snapshot repository.
zk.publish.release.url	ZK_PUBLISH_RELEASE_URL	URL of the release repository.
zk.publish.username	ZK_PUBLISH_USERNAME	Username for the repository.
zk.publish.password	ZK_PUBLISH_PASSWORD	Password for the repository.
signing.gnupg.keyName	-	Name of the key to sign the produced artifacts.