Mindolph Development

September 18, 2025 · View on GitHub

Prerequisites

JDK 23+
JavaFX 25+
Maven 3.x

How to setup develop environment

Install MFX
```
git clone https://github.com/mindolph/mfx.git
cd mfx
git switch main
mvn install -Dmaven.test.skip=true
```
If there is something wrong with the accessing Maven central repository, use the aliyun profile:
mvn install -Dmaven.test.skip=true -Paliyun

Install FontawesomeFX

git clone https://mindolph@bitbucket.org/mindolph-app/fontawesomefx.git
cd fontawesomefx/fontawesomefx
./gradlew publishToMavenLocal

for JDK 17, switch git branch:
git switch fontawesomefx-17.0.0

Mindolph
```
git clone https://github.com/mindolph/Mindolph.git
```
Use your favorite IDE to create a new project in the folder Mindolph/code. after compiling is completed, launch the application by executing the main method in class com.mindolph.fx.Launcher.

How to build an executable fat jar file

mvn package -Dmaven.test.skip=true

or

mvn package -Dmaven.test.skip=true -Paliyun

How to build platform-dependent distribution

Install Packaging Tools:
- macOS
  install Xcode command line tools
- Debian/Ubuntu
  install fakeroot package
- Fedora
  install rpm-build package
- Windows
  install third-party tool WiX 3.0 or latest
Install JavaFX jmods:

Download the latest JavaFX 25 jmods package from https://gluonhq.com/products/javafx/ and extract to somewhere like /usr/lib/javafx-jmods-25/

Set environment variable:
```
export JAVAFX_HOME=/usr/lib/javafx-jmods-25/
```
Build Mindolph distribution for your operating system:
```
mvn install -Dmaven.test.skip=true
```
or
```
mvn install -Dmaven.test.skip=true -Paliyun
```
When building is done, an executable jar file and an installer for your platform can be found in Mindolph/code/mindolph-desktop/target/