timefold-quickstarts

Why we included this project

Timefold Solver is a constraint solver for Java and Kotlin, and this repository collects working quickstarts that show how it behaves on real planning problems. You get runnable examples for vehicle routing, employee rostering, school timetabling, maintenance scheduling, task assignment, and a dozen or so other cases, each with the constraints written out and a small UI so you can watch the solver build a plan. The examples also work as a map from common business problems to the solver concepts you will actually need, such as chained planning variables, shadow variables, and time grains. The same school timetabling example appears as a Quarkus service, a plain library, and a Spring Boot integration, which makes the getting-started guides handy for teams weighing Timefold for production. It is a practical way to learn the modeling patterns before committing to a full implementation.