This is a tool for helping developers in a team, decide the combinations of how they will pair with each other.
Introduced as of 1.4.0 there is now a web application to make it easier for teams to choose their combinations.
It consists of a Next.js frontend, a Spring Boot backend and a database for persistence.
Each module is shipped as a docker image, please see the README.md for instructions on how to bring this stack up yourself.
Initially this project was a CLI only tool. For now, this is in maintenance mode in favour of the web application.
You can find more about it in the legacy module.
The core business logic of pair-stairs now resides in its own module core.
The algorithm for determining combinations is in here.
The basic requirements to build are:
- Make
- This is likely already available on your system if you are a developer
- Java 21
- This can be downloaded and managed with SDKMAN
- Node 20
- This can be downloaded and managed with nvm
- Maven
- This can be downloaded and managed with the included Maven wrapper script
- Docker
- Required to build the docker image
- Playwright
- Instructions for installing this can be found in the e2e module
Once SDKMAN has been installed, run sdk env to download and initialise your environment with the same
version of Java used in the project.
Once nvm has been installed, run nvm use to download and initialise your environment with the same
version of Node used in the project.
You should now be able to build the project using make build.