School Timetabling (Java, Quarkus, Maven or Gradle)

Assign lessons to timeslots and rooms to produce a better schedule for teachers and students.

quarkus school timetabling screenshot

Run the application
Run the packaged application
Run the application in a container
Run it native

Run the application

Git clone the timefold-quickstarts repo and navigate to this directory:

$ git clone https://github.com/TimefoldAI/timefold-quickstarts.git
...
$ cd timefold-quickstarts/use-cases/school-timetabling

Start the application with Maven:
```
$ mvn quarkus:dev
```
or with Gradle:
```
$ gradle quarkusDev
```
Visit http://localhost:8080 in your browser.
Click on the Solve button.

Then try live coding:

Make some changes in the source code.
Refresh your browser (F5).

Notice that those changes are immediately in effect.

Run the packaged application

When you’re done iterating in quarkus:dev mode, package the application to run as a conventional jar file.

Build it with Maven:
```
$ mvn package
```
or with Gradle:
```
$ gradle clean build
```
Run the Maven output:
```
$ java -jar ./target/quarkus-app/quarkus-run.jar
```
or the Gradle output:
```
$ java -jar ./build/quarkus-app/quarkus-run.jar
```
Note

To run it on port 8081 instead, add -Dquarkus.http.port=8081.
Visit http://localhost:8080 in your browser.
Click on the Solve button.

Run the application in a container

Build a container image:
```
$ mvn package -Dcontainer
```
The container image name

Run a container:

$ docker run -p 8080:8080 timefold-solver-quarkus-school-timetabling-quickstart:1.0-SNAPSHOT

Run it native

To increase startup performance for serverless deployments, build the application as a native executable:

Install GraalVM and gu install the native-image tool
Compile it natively. This takes a few minutes:
```
$ mvn package -Dnative
```
Run the native executable:
```
$ ./target/*-runner
```
Visit http://localhost:8080 in your browser.
Click on the Solve button.

More information

Visit timefold.ai.