Skip to content

Building From Source

To build Scoold from source code you’ll need JDK 21+ and Maven. Then just clone the repo and build the project:

Terminal window
git clone https://github.com/erudika/scoold.git
cd scoold
mvn clean install

To run a local instance of Scoold for development, use:

Terminal window
mvn -Dconfig.file=./scoold-application.conf spring-boot:run

To generate a WAR package, run:

Terminal window
mvn -Pwar package

To generate the native image, install GraalVM first and run:

Terminal window
mvn -Pnative clean package

To build Scoold Pro, you will need access to the Scoold Pro source code repo. For license holders with access to the Scoold Pro source code, the steps are as follows:

  1. Clone the Scoold Pro repository:
    Terminal window
    git clone https://git-codecommit.eu-west-1.amazonaws.com/v1/repos/scoold-pro
  2. Enter your username and password for the Git repository.
  3. Build Scoold Pro:
    Terminal window
    git clone https://github.com/erudika/scoold.git
    cd scoold-pro
    mvn clean install

You should be able to browse the source code with any of the Git graphic interface tools out there. Keep in mind that the repository is read-only, so you can only work with local branches and merge the latest changes from the main branch to your local branch.

  1. Fork this repository and clone the fork to your machine
  2. Create a branch (git checkout -b my-new-feature)
  3. Implement a new feature or fix a bug and add some tests
  4. Commit your changes (git commit -am 'Added a new feature')
  5. Push the branch to your fork on GitHub (git push origin my-new-feature)
  6. Create new Pull Request from your fork

Please try to respect the code style of this project. To check your code, run it through the style checker:

Terminal window
mvn validate